> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Comprobar la accesibilidad para IA de un dominio > Comprueba la política de robots.txt y las respuestas HTTP a pruebas con agentes de usuario de rastreadores desde la red de Athena. Usa result.evidence y los diagnósticos por agente; los desafíos, tiempos de espera y errores de servidor producen observaciones desconocidas. Búsqueda, recuperación y entrenamiento son independientes. Las pruebas no verifican el acceso de rastreadores reales ni garantizan indexación o citas. Los estados y booleanos antiguos se conservan por compatibilidad. Límite de 30 solicitudes por minuto y organización. ## OpenAPI ````yaml es/api-reference/openapi.json post /api/v1/ai-access/check openapi: 3.1.0 info: title: API de AthenaHQ description: >- La API de AthenaHQ ofrece acceso programático para gestionar tus sitios web y consultas para optimizar el contenido con IA. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Servidor de producción security: - apiKey: [] tags: - name: Basics description: Operaciones principales de la API para gestionar sitios web y consultas - name: Metrics description: Endpoints de métricas y análisis para monitorizar la visibilidad en IA - name: Billing description: Endpoints de facturación y créditos para gestionar el uso - name: Team Management description: Endpoints para gestionar miembros del equipo e invitaciones - name: Groups description: Endpoints para gestionar grupos de sitios web - name: Content description: >- Endpoints para acceder a los datos del centro de contenidos: pestañas, URL monitorizadas y desglose de consultas por URL. - name: Pitch Workspace description: >- Endpoints para acceder a los informes del espacio de propuestas: ejecuciones de propuestas con alcance de organización, con competidores, consultas, atributos y métricas agregadas. - name: Knowledge Base description: >- Endpoints para leer la base de conocimientos de la marca: datos aprobados sobre la marca y los pilares que los organizan. paths: /api/v1/ai-access/check: post: tags: - AI Access summary: Comprobar la accesibilidad para IA de un dominio description: >- Comprueba la política de robots.txt y las respuestas HTTP a pruebas con agentes de usuario de rastreadores desde la red de Athena. Usa result.evidence y los diagnósticos por agente; los desafíos, tiempos de espera y errores de servidor producen observaciones desconocidas. Búsqueda, recuperación y entrenamiento son independientes. Las pruebas no verifican el acceso de rastreadores reales ni garantizan indexación o citas. Los estados y booleanos antiguos se conservan por compatibilidad. Límite de 30 solicitudes por minuto y organización. operationId: checkAIAccess requestBody: required: true content: application/json: schema: type: object properties: domain: type: string description: Dominio que se comprobará (con o sin protocolo). example: example.com required: - domain responses: '200': description: Comprobación de acceso de IA completada correctamente. content: application/json: schema: $ref: '#/components/schemas/AIAccessCheckResponse' '400': description: Cuerpo de la solicitud no válido. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: 'Sin autorización: falta la clave de API o no es válida.' content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Límite de solicitudes alcanzado. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Error interno del servidor. content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] components: schemas: AIAccessCheckResponse: type: object description: Respuesta correcta de la comprobación de acceso de IA. properties: result: $ref: '#/components/schemas/AIAccessResult' diagnostics: $ref: '#/components/schemas/AIAccessDiagnostics' log: type: string description: >- Registro de diagnóstico en texto plano preparado para una incidencia del alojamiento o la CDN. Idéntico al texto que produce el botón `Copy log` de la aplicación web de AthenaHQ. required: - result - diagnostics - log Error: type: object description: Objeto de respuesta de error required: - error properties: error: type: string description: Mensaje de error que describe qué ha fallado example: Unauthorized AIAccessResult: type: object description: >- Observaciones de acceso de IA y campos de compatibilidad antiguos. Usa evidence y los diagnósticos por agente para obtener resultados fiables que admitan null. properties: domain: type: string description: Dominio que se ha comprobado. status: type: string enum: - accessible - partial - blocked description: >- Agregado antiguo conservado por compatibilidad. Usa evidence.status para distinguir las comprobaciones no concluyentes. http: $ref: '#/components/schemas/AIAccessUIBotAccess' description: >- Booleanos antiguos por modelo conservados por compatibilidad. Si Google-Extended no tiene observación HTTP, el entrenamiento de Gemini usa la respuesta medida de Googlebot como aproximación de compatibilidad, sin demostrar acceso ni permiso de entrenamiento. Usa evidence.http para observaciones por agente que admitan null y evidence.robots para la política independiente. robots: $ref: '#/components/schemas/AIAccessUIBotAccess' description: >- Valores booleanos antiguos por modelo conservados por compatibilidad. Usa evidence.robots para observaciones por agente que admitan null y para separar búsqueda y entrenamiento. hasSitemap: type: boolean description: >- Resultado opcional de un mapa del sitio verificado de forma independiente. La comprobación actual de acceso de IA no comprueba mapas del sitio y omite este campo. checkedAt: type: string format: date-time error: type: string description: Solo se rellena cuando han fallado ambas comprobaciones. evidence: type: object description: >- Observaciones de referencia. Las solicitudes proceden de Athena, no de rangos IP verificados de rastreadores. Null significa desconocido. ChatGPTUser es recuperación; OAISearchBot, búsqueda; GPTBot, entrenamiento. GoogleExtended es un token de política sin rastreador HTTP. Políticas y observaciones HTTP son independientes. No garantiza indexación ni citas. properties: version: type: integer enum: - 2 network: type: string enum: - athena status: type: string enum: - accessible - partial - blocked - inconclusive http: allOf: - $ref: '#/components/schemas/AIAccessRawEvidence' nullable: true robots: allOf: - $ref: '#/components/schemas/AIAccessRawEvidence' nullable: true required: - version - network - status - http - robots required: - domain - status - checkedAt AIAccessDiagnostics: type: object description: >- Identificador de diagnóstico de cada solicitud. Útil para abrir incidencias con el alojamiento o la CDN. properties: userAgentChecks: type: object additionalProperties: $ref: '#/components/schemas/AIAccessBotCheckDetail' description: >- Claves con el formato `${category}.${agentKey}`, p. ej., `chatgpt.GPTBot`. robotsCheck: $ref: '#/components/schemas/AIAccessRobotsCheckDetail' required: - userAgentChecks AIAccessUIBotAccess: type: object description: >- Mapa de accesibilidad por modelo. Las claves corresponden a los principales motores de respuestas. properties: chatgpt: $ref: '#/components/schemas/AIAccessBotDetails' claude: $ref: '#/components/schemas/AIAccessBotDetails' perplexity: $ref: '#/components/schemas/AIAccessBotDetails' gemini: $ref: '#/components/schemas/AIAccessBotDetails' copilot: $ref: '#/components/schemas/AIAccessBotDetails' grok: $ref: '#/components/schemas/AIAccessBotDetails' deepseek: $ref: '#/components/schemas/AIAccessBotDetails' rufus: $ref: '#/components/schemas/AIAccessBotDetails' AIAccessRawEvidence: type: object properties: chatgpt: type: object properties: ChatGPTUser: type: boolean nullable: true OAISearchBot: type: boolean nullable: true GPTBot: type: boolean nullable: true required: - ChatGPTUser - OAISearchBot - GPTBot claude: type: object properties: ClaudeUser: type: boolean nullable: true ClaudeSearchBot: type: boolean nullable: true ClaudeBot: type: boolean nullable: true required: - ClaudeUser - ClaudeSearchBot - ClaudeBot gemini: type: object properties: Googlebot: type: boolean nullable: true GoogleExtended: type: boolean nullable: true required: - Googlebot - GoogleExtended perplexity: type: object properties: PerplexityUser: type: boolean nullable: true PerplexityBot: type: boolean nullable: true required: - PerplexityUser - PerplexityBot copilot: type: object properties: Bingbot: type: boolean nullable: true required: - Bingbot grok: type: object properties: XAIBot: type: boolean nullable: true required: - XAIBot deepseek: type: object properties: DeepSeekBot: type: boolean nullable: true required: - DeepSeekBot rufus: type: object properties: Amazonbot: type: boolean nullable: true required: - Amazonbot required: - chatgpt - claude - gemini - perplexity - copilot - grok - deepseek - rufus AIAccessBotCheckDetail: type: object description: >- Detalle de diagnóstico por agente. Se utiliza para completar el registro que un socio puede pegar en una incidencia del alojamiento o la CDN. properties: category: type: string description: Categoría del modelo (chatgpt, claude, gemini, ...). agentKey: type: string description: Clave interna de la variante del agente de usuario. agentName: type: string description: >- Nombre legible del agente de usuario (p. ej., `GPTBot`, `Googlebot`). userAgent: type: string description: Cadena completa del agente de usuario enviada en la comprobación. accessible: type: boolean description: >- Indica si este agente de usuario ha recibido una respuesta HTTP correcta. status: type: - integer - 'null' description: Código de estado HTTP, o null si hay un error de red o transporte. finalUrl: type: - string - 'null' description: URL final tras las redirecciones, o null si se produce un error. headers: type: object additionalProperties: type: string description: >- Cabeceras de respuesta relevantes para la CDN (cf-ray, x-vercel-id, x-amz-cf-id, server, etc.). errorCode: type: - string - 'null' description: >- Código de error si la solicitud ha fallado (p. ej., `ENOTFOUND`, `ETIMEDOUT`). errorMessage: type: - string - 'null' durationMs: type: integer checkedAt: type: string format: date-time verdict: type: string enum: - allowed - challenged - blocked - error - not_tested description: >- Resultado observado de la comprobación. Challenged o error significa acceso desconocido. Los tokens que solo tienen política son not_tested. required: - category - agentKey - agentName - userAgent - accessible - status - finalUrl - headers - errorCode - errorMessage - durationMs - checkedAt AIAccessRobotsCheckDetail: type: object description: Diagnósticos de descarga de robots.txt. properties: url: type: string status: type: - integer - 'null' finalUrl: type: - string - 'null' headers: type: object additionalProperties: type: string errorCode: type: - string - 'null' errorMessage: type: - string - 'null' durationMs: type: integer checkedAt: type: string format: date-time source: type: string enum: - direct - fallback - missing required: - url - status - finalUrl - headers - errorCode - errorMessage - durationMs - checkedAt - source AIAccessBotDetails: type: object description: >- Valores booleanos de accesibilidad conversacional y de entrenamiento por modelo. properties: conversational: type: boolean description: >- Señal HTTP en tiempo real que indica que se permite el agente de usuario conversacional del modelo. training: type: boolean description: >- Señal HTTP en tiempo real que indica que se permite el rastreador de entrenamiento del modelo. required: - conversational - training securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- Clave de API para autenticarse. Puedes crear una [aquí](https://app.athenahq.ai/organization?tab=api). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.