> ## 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. # Vérifier l’accessibilité IA d’un domaine > Vérifie les règles robots.txt et les réponses HTTP aux tests d’agents utilisateurs depuis le réseau Athena. Utilisez result.evidence et les diagnostics par agent ; défis, délais et erreurs serveur donnent des observations inconnues. Recherche, récupération et entraînement sont distincts. Ces tests ne vérifient pas l’accès des vrais robots et ne garantissent ni indexation ni citations. Les anciens statuts/booléens restent pour compatibilité. Limite de 30 requêtes par minute et par organisation. ## OpenAPI ````yaml fr/api-reference/openapi.json post /api/v1/ai-access/check openapi: 3.1.0 info: title: API AthenaHQ description: >- L’API AthenaHQ permet de gérer vos sites et prompts par programme pour l’optimisation de contenu par IA. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Serveur de production security: - apiKey: [] tags: - name: Basics description: Opérations API principales pour gérer sites et prompts - name: Metrics description: Points de terminaison de métriques et analyses de visibilité IA - name: Billing description: Points de facturation et crédits pour gérer la consommation - name: Team Management description: Points de terminaison de gestion des membres et invitations - name: Groups description: Points de terminaison de gestion des groupes de sites - name: Content description: >- Points de terminaison Content Hub : onglets, URL suivies et détail des prompts par URL. - name: Pitch Workspace description: >- Points de terminaison des rapports Pitch Workspace : exécutions à l’échelle de l’organisation avec concurrents, prompts, attributs et métriques agrégées. - name: Knowledge Base description: >- Endpoints de lecture de la base de connaissances de la marque — faits approuvés et piliers qui les organisent. paths: /api/v1/ai-access/check: post: tags: - AI Access summary: Vérifier l’accessibilité IA d’un domaine description: >- Vérifie les règles robots.txt et les réponses HTTP aux tests d’agents utilisateurs depuis le réseau Athena. Utilisez result.evidence et les diagnostics par agent ; défis, délais et erreurs serveur donnent des observations inconnues. Recherche, récupération et entraînement sont distincts. Ces tests ne vérifient pas l’accès des vrais robots et ne garantissent ni indexation ni citations. Les anciens statuts/booléens restent pour compatibilité. Limite de 30 requêtes par minute et par organisation. operationId: checkAIAccess requestBody: required: true content: application/json: schema: type: object properties: domain: type: string description: Domaine à tester, avec ou sans protocole. example: example.com required: - domain responses: '200': description: Vérification d’accès IA réussie. content: application/json: schema: $ref: '#/components/schemas/AIAccessCheckResponse' '400': description: Corps de requête invalide. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Non autorisé — clé API invalide ou absente. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Limite de débit atteinte. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Erreur interne du serveur. content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] components: schemas: AIAccessCheckResponse: type: object description: Réponse de vérification d’accès IA réussie. properties: result: $ref: '#/components/schemas/AIAccessResult' diagnostics: $ref: '#/components/schemas/AIAccessDiagnostics' log: type: string description: >- Journal de diagnostic en texte brut adapté à un ticket d’hébergeur/CDN. Identique au bouton `Copy log` de l’application AthenaHQ. required: - result - diagnostics - log Error: type: object description: Objet de réponse d’erreur required: - error properties: error: type: string description: Message expliquant l’erreur example: Unauthorized AIAccessResult: type: object description: >- Observations AI Access et anciens champs de compatibilité. Utilisez evidence et les diagnostics par agent pour des résultats nullables faisant autorité. properties: domain: type: string description: Domaine testé. status: type: string enum: - accessible - partial - blocked description: >- Ancien agrégat conservé pour compatibilité. Utilisez evidence.status pour distinguer les vérifications non concluantes. http: $ref: '#/components/schemas/AIAccessUIBotAccess' description: >- Anciens booléens par modèle conservés pour compatibilité. Lorsque Google-Extended n’a aucune observation HTTP, l’entraînement Gemini utilise la réponse Googlebot mesurée comme approximation de compatibilité, pas comme preuve d’accès ni d’autorisation d’entraînement. Utilisez evidence.http pour les observations nullables par agent et evidence.robots pour la politique indépendante. robots: $ref: '#/components/schemas/AIAccessUIBotAccess' description: >- Anciens booléens par modèle conservés pour compatibilité. Utilisez evidence.robots pour les observations nullables par agent et la séparation recherche/entraînement. hasSitemap: type: boolean description: >- Résultat de sitemap facultatif vérifié indépendamment. Le test AI Access actuel ne vérifie pas les sitemaps et omet ce champ. checkedAt: type: string format: date-time error: type: string description: Rempli uniquement si les deux tests ont échoué. evidence: type: object description: >- Observations de référence. Requêtes depuis Athena, pas depuis des plages IP de robots vérifiées. Null signifie inconnu. ChatGPTUser sert à la récupération, OAISearchBot à la recherche, GPTBot à l’entraînement. GoogleExtended est un jeton de règles sans robot HTTP. Règles et observations HTTP sont indépendantes. Aucune garantie d’indexation ni de citations. 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: >- Empreinte de diagnostic par requête, utile pour les tickets d’hébergement ou de CDN. properties: userAgentChecks: type: object additionalProperties: $ref: '#/components/schemas/AIAccessBotCheckDetail' description: >- Clés au format `${category}.${agentKey}`, par exemple `chatgpt.GPTBot`. robotsCheck: $ref: '#/components/schemas/AIAccessRobotsCheckDetail' required: - userAgentChecks AIAccessUIBotAccess: type: object description: >- Correspondances d’accessibilité par modèle. Les clés désignent les principaux moteurs de réponse. 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: >- Diagnostic détaillé par agent, pour le journal qu’un partenaire peut coller dans un ticket d’hébergeur ou CDN. properties: category: type: string description: Catégorie du modèle (chatgpt, claude, gemini, ...). agentKey: type: string description: Clé interne de la variante d’agent utilisateur. agentName: type: string description: >- Nom lisible de l’agent utilisateur (par exemple `GPTBot`, `Googlebot`). userAgent: type: string description: Chaîne complète de l’agent utilisateur envoyée lors du test. accessible: type: boolean description: Indique si cet agent utilisateur a reçu une réponse HTTP réussie. status: type: - integer - 'null' description: Code HTTP, ou null en cas d’erreur réseau/transport. finalUrl: type: - string - 'null' description: URL finale après redirections, ou null en cas d’échec. headers: type: object additionalProperties: type: string description: >- En-têtes utiles au CDN (cf-ray, x-vercel-id, x-amz-cf-id, server, etc.). errorCode: type: - string - 'null' description: Code d’erreur de requête (par exemple `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: >- Résultat observé du test. Un défi ou une erreur indique un accès indéterminé. Les jetons de règles uniquement sont not_tested. required: - category - agentKey - agentName - userAgent - accessible - status - finalUrl - headers - errorCode - errorMessage - durationMs - checkedAt AIAccessRobotsCheckDetail: type: object description: Diagnostic de récupération 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: Booléens d’accessibilité conversationnelle/d’entraînement par modèle. properties: conversational: type: boolean description: >- Signal HTTP en direct indiquant que le user-agent conversationnel du modèle est autorisé. training: type: boolean description: >- Signal HTTP en direct indiquant que le robot d’entraînement du modèle est autorisé. required: - conversational - training securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- Clé API d’authentification. Créez-en une [ici](https://app.athenahq.ai/organization?tab=api). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.