Codes d'erreur

{ "error": { "code": "AIH-AUTH-0001",
             "message": "invalid login or password",
             "message_key": "err.auth.invalid_credentials",
             "details": { } } }

Chaque erreur d'API AiHummer comporte un **code machine stable** sous forme `AIH-<DOMAIN>-<NNNN>`. La forme du fil est : ```json { "error": { "code": "AIH-AUTH-0001", "message": "invalid login or password", "message_key": "err.auth.invalid_credentials", "details": { } } } ``` `code` est stable (jamais réutilisé ou renuméroté); `message` est une chaîne anglaise humaine ; `message_key` est la clé i18n que les clients utilisent pour localiser ; `details` est un contexte structuré optionnel. > Erreurs de facturation / d'éligibilité au forfait (le message 402 « mise à niveau requise » apparaît) sont **pas** listé ici — voir [Licences et facturation](/fr/v1.0/commercial/licensing). ## COMMUN Erreurs transversales partagées par tous les services (forme de la requête, méthode, authentification, pannes internes). Un code spécifique au domaine est préféré lorsqu'il convient. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-COMMON-0001` | 405 | Méthode non autorisée | `err.common.method_not_allowed` | La méthode HTTP n'est pas autorisée pour cette route. | | `AIH-COMMON-0002` | 400 | Corps de la requête invalide | `err.common.invalid_body` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-COMMON-0003` | 400 | Un champ requis est manquant | `err.common.missing_field` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-COMMON-0004` | 500 | Erreur interne | `err.common.internal` | Une défaillance interne inattendue. | | `AIH-COMMON-0005` | 404 | Non trouvé | `err.common.not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-COMMON-0006` | 403 | interdite | `err.common.forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-COMMON-0007` | 501 | Fonctionnalité non activée | `err.common.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-COMMON-0008` | 401 | Non autorisé | `err.common.unauthorized` | Identifiants manquants ou invalides. | | `AIH-COMMON-0009` | 400 | Échec de la validation | `err.common.validation` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-COMMON-0010` | 409 | Conflit | `err.common.conflict` | Conflits avec l'état actuel. | | `AIH-COMMON-0011` | 429 | Limite de taux dépassée | `err.common.rate_limited` | Trop de requêtes / au-delà du budget configuré. | | `AIH-COMMON-0012` | 502 | Erreur en amont | `err.common.upstream` | Un appel en amont/fournisseur a échoué. | ## AUTH Admin local-auth : connexion, sessions, changement de mot de passe, gestion des utilisateurs, 2FA. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-AUTH-0001` | 401 | Identifiant ou mot de passe invalide | `err.auth.invalid_credentials` | Identifiants manquants ou invalides. | | `AIH-AUTH-0002` | 429 | Trop de tentatives, essayez à nouveau plus tard | `err.auth.too_many_attempts` | Trop de requêtes / au-delà du budget configuré. | | `AIH-AUTH-0003` | 401 | Non authentifié | `err.auth.not_authenticated` | Identifiants manquants ou invalides. | | `AIH-AUTH-0004` | 501 | Authentification locale non activée | `err.auth.local_disabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-AUTH-0005` | 403 | Le mot de passe actuel est incorrect | `err.auth.wrong_current_password` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-AUTH-0006` | 409 | Vous ne pouvez pas supprimer votre propre compte | `err.auth.cannot_delete_self` | Conflits avec l'état actuel. | | `AIH-AUTH-0007` | 500 | Impossible de créer la session | `err.auth.session_failed` | Une défaillance interne inattendue. | | `AIH-AUTH-0008` | 501 | Authentification à deux facteurs non activée | `err.auth.twofa_disabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-AUTH-0009` | 401 | Le défi a expiré — connectez-vous à nouveau | `err.auth.twofa_challenge_expired` | Identifiants manquants ou invalides. | | `AIH-AUTH-0010` | 401 | Code invalide | `err.auth.twofa_invalid_code` | Identifiants manquants ou invalides. | | `AIH-AUTH-0011` | 401 | Code de récupération invalide | `err.auth.twofa_invalid_recovery` | Identifiants manquants ou invalides. | | `AIH-AUTH-0012` | 401 | La vérification du second facteur a échoué | `err.auth.twofa_verify_failed` | Identifiants manquants ou invalides. | | `AIH-AUTH-0013` | 400 | Aucun deuxième facteur correspondant n'est enregistré | `err.auth.twofa_not_enrolled` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-AUTH-0014` | 400 | Jeton de réinitialisation invalide ou expiré | `err.auth.reset_token_invalid` | Entrée de requête malformée, incomplète ou invalide. | ## AGENT CRUD des employés IA (agents), versions, clonage, et le profil de prompt système par agent. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-AGENT-0001` | 501 | Agents non activés | `err.agent.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-AGENT-0002` | 404 | Agent non trouvé | `err.agent.not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-AGENT-0003` | 403 | Pas votre agent | `err.agent.forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-AGENT-0004` | 501 | Profils d'agent non activés | `err.agent.profile_not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-AGENT-0005` | 404 | Section partagée introuvable | `err.agent.section_not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-AGENT-0006` | 403 | Pas votre section partagée | `err.agent.section_forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-AGENT-0007` | 400 | Type de section inconnu | `err.agent.unknown_section_kind` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-AGENT-0008` | 403 | Outil non autorisé pour cet agent | `err.agent.tool_not_permitted` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-AGENT-0009` | 403 | Limite de profondeur du sous-agent atteinte | `err.agent.subagent_depth_exceeded` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-AGENT-0010` | 403 | Transfert non disponible ici | `err.agent.handoff_unavailable` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-AGENT-0011` | 500 | L'appel de l'outil a échoué | `err.agent.tool_failed` | Une défaillance interne inattendue. | | `AIH-AGENT-0012` | 400 | Le transfert nécessite un 'agent' et une 'tâche' | `err.agent.handoff_invalid_args` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-AGENT-0013` | 404 | Aucun agent avec ce nom | `err.agent.handoff_target_not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-AGENT-0014` | 400 | Aucune tâche fournie | `err.agent.subagent_no_tasks` | Entrée de requête malformée, incomplète ou invalide. | ## CLÉAPI Clés API pour l'accès programmatique à la passerelle : le sous-système de clés n'est pas configuré. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-APIKEY-0001` | 501 | Clés API non configurées | `err.apikey.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## APPROBATION File d'attente d'approbation avec intervention humaine : la fonction d'approbation est désactivée. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | Approbations non activées | `err.approval.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## ARTÉFACT Artefacts de conversation (documents + code exécutable) : exécution du code désactivée, artefact/version manquant(e), type incorrect ou sortie du runner incorrecte. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-ARTIFACT-0001` | 501 | Exécution du code non activée | `err.artifact.exec_disabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-ARTIFACT-0002` | 404 | Artéfact non trouvé | `err.artifact.not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-ARTIFACT-0003` | 404 | Version de l'artefact non trouvée | `err.artifact.version_not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-ARTIFACT-0004` | 400 | Un artefact n'est pas du code | `err.artifact.not_code` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-ARTIFACT-0005` | 500 | Mauvaise sortie du coureur | `err.artifact.bad_runner_output` | Une défaillance interne inattendue. | | `AIH-ARTIFACT-0006` | 400 | Le type doit être un document ou un code | `err.artifact.invalid_kind` | Entrée de requête malformée, incomplète ou invalide. | ## SAUVEGARDE Sauvegarde de la base de données depuis la surface d'administration. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-BACKUP-0001` | 501 | URL de la base de données non configurée pour la sauvegarde | `err.backup.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-BACKUP-0002` | 500 | Sauvegarde échouée | `err.backup.failed` | Une défaillance interne inattendue. | ## LOT Traitement des demandes par lots. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-BATCH-0001` | 501 | Lots non activés | `err.batch.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-BATCH-0002` | 404 | Lot non trouvé | `err.batch.not_found` | L'objet référencé n'existe pas ou est hors de portée. | ## BUDGET Mesure de l'utilisation et budgets de dépenses par modèle. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-BUDGET-0001` | 501 | Mesure de l'utilisation non activée | `err.budget.usage_not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-BUDGET-0002` | 501 | Budgets non activés | `err.budget.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## Apportez votre propre clé Apportez votre propre clé : clés du fournisseur de modèle fournies par le locataire. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-BYOK-0001` | 501 | BYOK non configuré | `err.byok.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## CHANGER Enregistrements de modifications et le flux de travail d'approbation des modifications. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-CHANGE-0001` | 404 | Changement non trouvé | `err.change.not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-CHANGE-0002` | 403 | Auto-approbation non autorisée : un autre approbateur est requis | `err.change.self_approval_forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | ## bavarder Point de terminaison de complétions de chat compatible OpenAI. La forme du fil reste compatible OpenAI tout en ajoutant un code stable. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | Point de terminaison compatible OpenAI désactivé | `err.chat.disabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-CHAT-0002` | 401 | Clé API invalide | `err.chat.invalid_key` | Identifiants manquants ou invalides. | | `AIH-CHAT-0003` | 400 | Demande de chat invalide | `err.chat.invalid_request` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-CHAT-0004` | 429 | Taux ou limite de budget dépassé | `err.chat.rate_limited` | Trop de requêtes / au-delà du budget configuré. | | `AIH-CHAT-0005` | 502 | Le changement de chat a échoué | `err.chat.turn_failed` | Un appel en amont/fournisseur a échoué. | | `AIH-CHAT-0006` | 500 | Échec de la complétion du chat | `err.chat.internal` | Une défaillance interne inattendue. | ## CONNEXION Intégration des connexions OAuth : connecter les tickets, les étapes d'autorisation et l'échange de jetons. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-CONNECTION-0001` | 400 | Ticket de connexion invalide ou expiré | `err.connection.ticket_invalid` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-CONNECTION-0002` | 400 | Le plugin ne déclare pas de flux OAuth | `err.connection.no_oauth_flow` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-CONNECTION-0003` | 400 | Client OAuth non configuré pour ce plugin | `err.connection.oauth_client_not_configured` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-CONNECTION-0004` | 400 | Autorisation refusée | `err.connection.auth_denied` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-CONNECTION-0005` | 400 | Code ou état manquant | `err.connection.missing_code_or_state` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-CONNECTION-0006` | 400 | État invalide ou expiré | `err.connection.state_invalid` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-CONNECTION-0007` | 400 | Configuration du plugin OAuth indisponible | `err.connection.oauth_config_unavailable` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-CONNECTION-0008` | 502 | Échec de l'échange de jetons | `err.connection.token_exchange_failed` | Un appel en amont/fournisseur a échoué. | | `AIH-CONNECTION-0009` | 500 | Impossible de stocker le jeton | `err.connection.store_token_failed` | Une défaillance interne inattendue. | ## IDENTIFIANT Opérations de coffre-fort d'identifiants par utilisateur. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-CREDENTIAL-0001` | 501 | Coffre de certificats non activé | `err.credential.vault_not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-CREDENTIAL-0002` | 400 | L'opération d'authentification a échoué | `err.credential.vault_error` | Entrée de requête malformée, incomplète ou invalide. | ## APPAREIL L'appareil fait le pont vers l'application compagnon sur l'appareil. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-DEVICE-0001` | 503 | Service de l'appareil indisponible | `err.device.service_unavailable` | Un service dépendant est temporairement indisponible. | ## ÉVÉNEMENTS Le flux d'événements du serveur (SSE) pour l'interface administrateur et les clients. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-EVENTS-0001` | 500 | Diffusion non prise en charge | `err.events.streaming_unsupported` | Une défaillance interne inattendue. | ## FAIT Faits sur les utilisateurs dans la mémoire à long terme. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-FACT-0001` | 404 | Fait non trouvé | `err.fact.not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-FACT-0002` | 403 | Pas un fait d'utilisateur | `err.fact.not_user_fact` | La ressource appartient à un autre locataire/propriétaire/session. | ## GRAPHIQUE Graphes d'agents : orchestration multi-agent déclarative. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-GRAPH-0001` | 501 | Graphiques de l'agent non activés | `err.graph.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-GRAPH-0002` | 404 | Graphique introuvable | `err.graph.not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-GRAPH-0003` | 403 | Pas ton graphique | `err.graph.forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-GRAPH-0004` | 501 | Exécution de graphique non disponible dans ce déploiement | `err.graph.exec_unavailable` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## Garde-corps Règles de garde-fou en matière de contenu/comportement pour les agents. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-GUARDRAIL-0001` | 501 | Garde-corps non configurés | `err.guardrail.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## ENTRANT Points de terminaison génériques de webhook/ingestion entrants : ingestion de messages canal→passerelle. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | Non autorisé | `err.inbound.unauthorized` | Identifiants manquants ou invalides. | | `AIH-INBOUND-0002` | 400 | Charge utile entrante invalide | `err.inbound.invalid_payload` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-INBOUND-0003` | 500 | L'expédition entrante a échoué | `err.inbound.dispatch_failed` | Une défaillance interne inattendue. | ## IPALLOW Listes d'accès IP autorisées pour les administrateurs. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-IPALLOW-0001` | 501 | Liste blanche IP non configurée | `err.ipallow.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## Ko Connecteurs de base de connaissances : fonctionnalité RAG désactivée, configuration du connecteur stockée corrompue ou archive téléchargée incorrecte. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-KB-0001` | 501 | Base de connaissances non activée | `err.kb.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-KB-0002` | 500 | Configuration enregistrée corrompue | `err.kb.config_corrupt` | Une défaillance interne inattendue. | | `AIH-KB-0003` | 400 | Archive de connaissances invalide | `err.kb.invalid_archive` | Entrée de requête malformée, incomplète ou invalide. | ## LICENCE Licence d’instance : application de la licence signée. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-LICENSE-0001` | 501 | Licence non activée | `err.license.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-LICENSE-0002` | 400 | Licence invalide | `err.license.invalid` | Entrée de requête malformée, incomplète ou invalide. | ## LLM Flux d'autorisation de l'appareil "Connect Codex (abonnement ChatGPT)" dans le produit. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex connect n'est pas disponible : le coffre-fort des secrets (AIHUMMER_MASTER_KEY) n'est pas configuré | `err.llm.codex_connect_disabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-LLM-0002` | 502 | Impossible de démarrer le flux d'autorisation de l'appareil Codex | `err.llm.codex_connect_start_failed` | Un appel en amont/fournisseur a échoué. | | `AIH-LLM-0003` | 500 | Impossible de supprimer la connexion Codex enregistrée | `err.llm.codex_disconnect_failed` | Une défaillance interne inattendue. | ## MARCHÉ Chemin d'installation du marché des plugins : le slug est validé par rapport au catalogue avant le déploiement asynchrone. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | Module inconnu : non dans le catalogue | `err.marketplace.unknown_module` | L'objet référencé n'existe pas ou est hors de portée. | ## MÉDIA Points de terminaison de récupération/flux de blob média : accès aux médias par jeton signé. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | Média non trouvé | `err.media.not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-MEDIA-0002` | 403 | Jeton média invalide ou expiré | `err.media.token_invalid` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-MEDIA-0003` | 503 | Compréhension vidéo non configurée | `err.media.video_not_configured` | Un service dépendant est temporairement indisponible. | ## MÉMOIRE Mémoire à long terme (Einstein) surface d'administration : le backend de mémoire n'est pas connecté. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | Mémoire non configurée | `err.memory.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## ACCÈS AU MODÈLE Règles d'accès aux modèles (quels modèles sont disponibles pour quels utilisateurs/agents). | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-MODELACCESS-0001` | 501 | Accès au modèle non configuré | `err.modelaccess.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## MODULE Surface de contrôle du marché des plugins/modules : fonctionnalité désactivée, source/installation manquante, propriété ou téléchargement latéral mal formé. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | Marché non activé | `err.module.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-MODULE-0002` | 404 | Source non trouvée | `err.module.source_not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-MODULE-0003` | 404 | Installation non trouvée | `err.module.installation_not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-MODULE-0004` | 403 | Pas votre installation | `err.module.installation_forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-MODULE-0005` | 501 | Téléversement de plugin désactivé (pas de magasin de blobs) | `err.module.upload_disabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-MODULE-0006` | 400 | Bundle de téléchargement de plugin invalide | `err.module.invalid_bundle` | Entrée de requête malformée, incomplète ou invalide. | ## APPARIEMENT Appairage d'appareil (utilisation de QR), validation de session de l'appareil, statut de liaison. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-PAIRING-0001` | 400 | Code d'appairage requis | `err.pairing.code_required` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-PAIRING-0002` | 401 | Code de jumelage invalide ou expiré | `err.pairing.invalid_code` | Identifiants manquants ou invalides. | | `AIH-PAIRING-0003` | 401 | Mauvais secret entrant | `err.pairing.bad_inbound_secret` | Identifiants manquants ou invalides. | | `AIH-PAIRING-0004` | 400 | Un champ requis est manquant | `err.pairing.field_required` | Entrée de requête malformée, incomplète ou invalide. | | `AIH-PAIRING-0005` | 401 | Session invalide ou expirée | `err.pairing.session_invalid` | Identifiants manquants ou invalides. | | `AIH-PAIRING-0006` | 400 | Jeton requis | `err.pairing.token_required` | Entrée de requête malformée, incomplète ou invalide. | ## TERRAIN DE JEUX L'aire de jeu pour les invites/modèles. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-PLAYGROUND-0001` | 501 | Aire de jeux non activée | `err.playground.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## INVITE La bibliothèque de prompts/modèles. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-PROMPT-0001` | 501 | Bibliothèque de prompts non configurée | `err.prompt.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-PROMPT-0002` | 404 | Modèle introuvable | `err.prompt.template_not_found` | L'objet référencé n'existe pas ou est hors de portée. | ## POUSSER Notifications push mobiles via le relais push du fournisseur (l’instance ne contient aucune information d’identification du fournisseur). | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-PUSH-0001` | 503 | Relais de notification push indisponible (service de notification push du fournisseur indisponible / instance non enregistrée) | `err.push.relay_unavailable` | Un service dépendant est temporairement indisponible. | | `AIH-PUSH-0002` | 502 | Échec de la livraison du relais push | `err.push.relay_failed` | Un appel en amont/fournisseur a échoué. | ## REGEN Régénération de la réponse (régénérer). | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-REGEN-0001` | 501 | Régénération non activée | `err.regen.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## SAML Authentification unique SAML. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-SAML-0001` | 501 | SAML non disponible | `err.saml.not_available` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-SAML-0002` | 400 | Assertion sans sujet | `err.saml.assertion_invalid` | Entrée de requête malformée, incomplète ou invalide. | ## HORAIRE Envoi de messages planifiés/différés. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-SCHEDULE-0001` | 404 | Horaires introuvables | `err.schedule.not_found` | L'objet référencé n'existe pas ou est hors de portée. | ## SCIM Provisionnement des utilisateurs SCIM. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-SCIM-0001` | 501 | SCIM non activé | `err.scim.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## secrète Coffre-fort secret par locataire : la clé maître est absente, ou le secret nommé n'existe pas. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | Secrets non configurés | `err.secret.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-SECRET-0002` | 404 | Secret non trouvé | `err.secret.not_found` | L'objet référencé n'existe pas ou est hors de portée. | ## SENTIMENT Analyse des conversations : sentiment et qualité. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-SENTIMENT-0001` | 501 | L'analyse des conversations n'est pas activée | `err.sentiment.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-SENTIMENT-0002` | 404 | Pas encore analysé | `err.sentiment.not_analyzed` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-SENTIMENT-0003` | 422 | Impossible d'analyser la conversation | `err.sentiment.unprocessable` | La demande est valide mais le contenu n'a pas pu être traité. | ## SESSION Conversation/session + surface de message administrateur : fonction désactivée, ou la conversation/le message n’appartient pas à l’appelant. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-SESSION-0001` | 501 | Conversations non activées | `err.session.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-SESSION-0002` | 403 | Pas ta conversation | `err.session.conversation_forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | | `AIH-SESSION-0003` | 403 | Pas ton message | `err.session.message_forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | ## COMPÉTENCE Compétences de l'agent : bibliothèque et propriété. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-SKILL-0001` | 501 | Compétences non activées | `err.skill.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-SKILL-0002` | 404 | Compétence non trouvée | `err.skill.not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-SKILL-0003` | 403 | Pas votre compétence | `err.skill.forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | ## SKILLOPT L'optimiseur de compétences : propositions d'amélioration des compétences. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-SKILLOPT-0001` | 501 | Optimiseur de compétences non activé | `err.skillopt.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-SKILLOPT-0002` | 404 | Proposition introuvable | `err.skillopt.proposal_not_found` | L'objet référencé n'existe pas ou est hors de portée. | | `AIH-SKILLOPT-0003` | 403 | Pas votre proposition | `err.skillopt.proposal_forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | ## SYSTÈME Opérations du système hôte : journaux et mise à jour automatique. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-SYSTEM-0001` | 501 | Journaux non disponibles sur cet hôte | `err.system.logs_unavailable` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-SYSTEM-0002` | 501 | Auto-mise à jour non configurée ; exécutez `sudo aihummer update` sur l'hôte | `err.system.update_not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | ## UTILISATEUR Gestion des utilisateurs et des rôles de l'espace de travail. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-USER-0001` | 409 | Vous ne pouvez pas changer vos propres rôles | `err.user.cannot_change_own_roles` | Conflits avec l'état actuel. | | `AIH-USER-0002` | 409 | Impossible de supprimer le dernier propriétaire | `err.user.cannot_remove_last_owner` | Conflits avec l'état actuel. | ## VOIX Point de terminaison de tour vocal (/v1/voice/turn) : la passerelle SIP → surface audio du tour de la passerelle. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | Impossible de résoudre la conversation | `err.voice.resolve_failed` | Un appel en amont/fournisseur a échoué. | | `AIH-VOICE-0002` | 502 | Échec du changement de voix | `err.voice.turn_failed` | Un appel en amont/fournisseur a échoué. | ## WEBCONN Backend Admin Sessions : session du navigateur et conversation SSE. Les événements d’erreur du flux SSE ne font pas partie de ce format d’erreur. | Code | HTTP | Signification | Clé i18n | Cause habituelle | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | La conversation n’appartient pas à votre session | `err.webconn.forbidden` | La ressource appartient à un autre locataire, propriétaire ou session. | | `AIH-WEBCONN-0002` | 500 | Diffusion non prise en charge | `err.webconn.streaming_unsupported` | Une défaillance inattendue s’est produite. | ## WEBHOOK Webhooks sortants pour les événements d'instance. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-WEBHOOK-0001` | 501 | Webhooks non activés | `err.webhook.not_enabled` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-WEBHOOK-0002` | 404 | Webhook introuvable | `err.webhook.not_found` | L'objet référencé n'existe pas ou est hors de portée. | ## ESPACE DE TRAVAIL Propriété/portée de l'espace de travail : le locataire en exercice a agi sur un espace de travail qu'il ne possède pas. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | Pas votre espace de travail | `err.workspace.forbidden` | La ressource appartient à un autre locataire/propriétaire/session. | ## ZAPIER Le déclencheur entrant du connecteur Zapier. | Code | HTTP | Sens | clé i18n | Cause typique | | --- | --- | --- | --- | --- | | `AIH-ZAPIER-0001` | 501 | Déclencheur entrant non configuré | `err.zapier.not_configured` | La fonctionnalité/l'intégration est désactivée ou non configurée. | | `AIH-ZAPIER-0002` | 401 | Signature ou jeton de déclencheur invalide | `err.zapier.invalid_signature` | Identifiants manquants ou invalides. |