Passer au contenu principal
L’API AI Access vérifie les règles robots.txt et envoie des requêtes HTTP utilisant les agents utilisateurs des robots d’IA depuis le réseau d’Athena. Ces éléments vous permettent d’analyser les échecs de requête ou de transmettre un diagnostic à votre hébergeur ou à votre CDN. Ces tests ne vérifient pas l’accès depuis les plages d’adresses IP des véritables robots et ne garantissent ni l’indexation ni les citations.

​
Informations renvoyées

  • result.evidence contient les observations de référence pour chaque agent. http vaut true si le test réussit, false s’il est refusé et null si l’accès est indéterminé. robots indique les règles indépendamment, ou vaut null lorsque le fichier n’a pas pu être évalué. network vaut athena et version vaut 2.
  • diagnostics consigne pour chaque requête le statut HTTP, le verdict, les en-têtes de réponse, le code d’erreur, la durée et l’horodatage UTC. Utilisez ces empreintes pour retrouver les requêtes dans les journaux de votre serveur ou CDN. Les jetons servant uniquement aux règles utilisent not_tested, sans statut HTTP ni erreur de requête.
  • log présente le diagnostic des requêtes dans un format adapté à un ticket d’assistance. Son statut global utilise result.evidence.status pour distinguer un accès indéterminé d’un blocage.
Les anciens champs result.status, result.http et result.robots sont conservés pour des raisons de compatibilité. Ils regroupent les rôles des robots et ne permettent pas d’identifier un accès indéterminé. Lorsque Google-Extended n’a aucune observation HTTP, l’ancien booléen result.http.gemini.training utilise la réponse mesurée de Googlebot comme approximation de compatibilité. Cela ne prouve ni l’accès ni l’autorisation pour l’entraînement de Gemini. Les règles robots.txt de Google-Extended restent indépendantes et ses données HTTP brutes restent null, car Google-Extended n’a pas d’agent utilisateur HTTP dédié. Les nouvelles intégrations doivent utiliser result.evidence et les diagnostics par agent. Ce test ne vérifie pas les sitemaps.

​
Distinguer recherche, récupération et entraînement

​
Valeurs du statut des observations

result.evidence.status résume les observations HTTP, indépendamment de robots.txt. Google-Extended en est exclu, car il n’a pas de robot HTTP. Un défi de vérification peut renvoyer HTTP 200. Les défis, les limites de débit, les défaillances réseau, les délais d’attente et les erreurs serveur ordinaires correspondent à un accès indéterminé. Une requête refusée renseigne également sur le test d’Athena, sans prouver que le véritable robot est bloqué. Confirmez le trafic réel des robots à l’aide des journaux de votre serveur ou CDN.

​
Limites de débit et authentification

Utilisez l’authentification standard par clé API AthenaHQ. Le point de terminaison autorise 30 requêtes par minute et par organisation. Tout dépassement renvoie 429 avec Retry-After.

​
Référence du point de terminaison

Consultez POST /api/v1/ai-access/check pour obtenir le schéma complet des requêtes et des réponses.