Saltar al contenido principal
La API de acceso de IA comprueba la política de robots.txt y envía solicitudes HTTP con agentes de usuario de rastreadores de IA desde la red de Athena. Utiliza los resultados para investigar solicitudes fallidas o compartir diagnósticos con tu proveedor de alojamiento o CDN. Estas comprobaciones no verifican el acceso desde los rangos de IP de los rastreadores reales ni garantizan la indexación o las citas.

​
Qué devuelve

  • result.evidence contiene las observaciones de referencia de cada agente. http indica true si se ha superado la comprobación, false si la solicitud se ha denegado y null si el acceso es desconocido. robots informa de la política de forma independiente, o devuelve null cuando no se ha podido evaluar el archivo. network es athena y version es 2.
  • diagnostics registra el estado HTTP, el veredicto, las cabeceras de respuesta, el código de error, la duración y la marca de tiempo UTC de cada solicitud. Utiliza estos datos para localizar las solicitudes en los registros de tu servidor o CDN. Los identificadores que solo expresan una política utilizan not_tested, sin estado HTTP ni error de solicitud.
  • log presenta los diagnósticos de las solicitudes con un formato adecuado para una incidencia de soporte. Su estado global utiliza result.evidence.status para distinguir el acceso desconocido de un bloqueo.
Los campos anteriores result.status, result.http y result.robots se mantienen por compatibilidad. Combinan las funciones de los rastreadores y no permiten distinguir el acceso desconocido. Cuando no hay una observación HTTP de Google-Extended, el booleano anterior result.http.gemini.training utiliza la respuesta medida de Googlebot como referencia de compatibilidad. Esto no demuestra que Gemini tenga acceso o permiso para usar el contenido en su entrenamiento. La política de robots.txt de Google-Extended se mantiene independiente y su evidencia HTTP sin procesar sigue siendo null, ya que Google-Extended no tiene un agente de usuario HTTP dedicado. Las nuevas integraciones deben utilizar result.evidence y los diagnósticos por agente. Esta comprobación no analiza los sitemaps.

​
Búsqueda, recuperación y entrenamiento por separado

​
Valores del estado de la evidencia

result.evidence.status resume las observaciones HTTP de forma independiente de robots.txt. Google-Extended queda excluido porque no tiene rastreador HTTP. Un desafío de seguridad puede devolver HTTP 200. Los desafíos, los límites de solicitudes, los fallos de red, los tiempos de espera agotados y los errores habituales del servidor significan que el acceso es desconocido. Una solicitud denegada también aporta evidencia sobre la comprobación de Athena, sin demostrar por sí sola que el rastreador real esté bloqueado. Confirma el tráfico real del rastreador en los registros de tu servidor o CDN.

​
Límites de solicitudes y autenticación

Utiliza la autenticación estándar mediante claves de API de AthenaHQ. El endpoint permite 30 solicitudes por minuto por organización. Si superas el límite, devuelve 429 con Retry-After.

​
Referencia del endpoint

Consulta POST /api/v1/ai-access/check para ver el esquema completo de la solicitud y la respuesta.