Coduri de eroare

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

Fiecare eroare a API-ului AiHummer poartă un **cod-mașină stabil** de forma `AIH-<DOMAIN>-<NNNN>`. Forma pe fir este: ```json { "error": { "code": "AIH-AUTH-0001", "message": "invalid login or password", "message_key": "err.auth.invalid_credentials", "details": { } } } ``` `code` este stabil (nu este niciodată reutilizat sau renumerotat); `message` este un șir lizibil în engleză; `message_key` este cheia i18n pe care clienții o folosesc pentru a localiza; `details` este un context structurat opțional. Codurile sunt sursa unică de adevăr în `internal/apierr`, iar această pagină reflectă acel registru. > Erorile de facturare / drepturi de plan (suprafața 402 „upgrade required”) **nu** sunt listate aici — ele sunt documentate în documentația de facturare. ## COMMON Erori transversale partajate de fiecare serviciu (forma cererii, metoda, autentificarea, eșecuri interne). Un cod specific domeniului este preferat atunci când se potrivește unul. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-COMMON-0001` | 405 | metodă nepermisă | `err.common.method_not_allowed` | Metoda HTTP nu este permisă pentru această rută. | | `AIH-COMMON-0002` | 400 | corp de cerere invalid | `err.common.invalid_body` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-COMMON-0003` | 400 | lipsește un câmp obligatoriu | `err.common.missing_field` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-COMMON-0004` | 500 | eroare internă | `err.common.internal` | Un eșec intern neașteptat. | | `AIH-COMMON-0005` | 404 | negăsit | `err.common.not_found` | Obiectul referit nu există sau este în afara domeniului. | | `AIH-COMMON-0006` | 403 | interzis | `err.common.forbidden` | Un eșec intern neașteptat. | | `AIH-COMMON-0007` | 501 | funcționalitate neactivată | `err.common.not_enabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-COMMON-0008` | 401 | neautorizat | `err.common.unauthorized` | Credențiale lipsă sau invalide. | | `AIH-COMMON-0009` | 400 | validare eșuată | `err.common.validation` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-COMMON-0010` | 409 | conflict | `err.common.conflict` | Conflict cu starea curentă. | | `AIH-COMMON-0011` | 429 | limită de rată depășită | `err.common.rate_limited` | Prea multe cereri / peste bugetul configurat. | | `AIH-COMMON-0012` | 502 | eroare upstream | `err.common.upstream` | Un apel upstream/furnizor a eșuat. | ## AUTH Autentificare locală de administrare: login, sesiuni, schimbare de parolă, gestionarea utilizatorilor, 2FA. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-AUTH-0001` | 401 | login sau parolă invalidă | `err.auth.invalid_credentials` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-AUTH-0002` | 429 | prea multe încercări, reîncearcă mai târziu | `err.auth.too_many_attempts` | Prea multe cereri / peste bugetul configurat. | | `AIH-AUTH-0003` | 401 | neautentificat | `err.auth.not_authenticated` | Credențiale lipsă sau invalide. | | `AIH-AUTH-0004` | 501 | autentificarea locală nu este activată | `err.auth.local_disabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-AUTH-0005` | 403 | parola curentă este greșită | `err.auth.wrong_current_password` | Resursa aparține altui chiriaș/proprietar/sesiune. | | `AIH-AUTH-0006` | 409 | nu îți poți șterge propriul cont | `err.auth.cannot_delete_self` | Conflict cu starea curentă. | | `AIH-AUTH-0007` | 500 | nu s-a putut crea sesiunea | `err.auth.session_failed` | Un eșec intern neașteptat. | | `AIH-AUTH-0008` | 501 | autentificarea cu doi factori nu este activată | `err.auth.twofa_disabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-AUTH-0009` | 401 | provocare expirată — autentifică-te din nou | `err.auth.twofa_challenge_expired` | Credențiale lipsă sau invalide. | | `AIH-AUTH-0010` | 401 | cod invalid | `err.auth.twofa_invalid_code` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-AUTH-0011` | 401 | cod de recuperare invalid | `err.auth.twofa_invalid_recovery` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-AUTH-0012` | 401 | verificarea celui de-al doilea factor a eșuat | `err.auth.twofa_verify_failed` | Credențiale lipsă sau invalide. | | `AIH-AUTH-0013` | 400 | niciun al doilea factor potrivit înrolat | `err.auth.twofa_not_enrolled` | Intrare de cerere malformată, incompletă sau invalidă. | ## PAIRING Pairing de dispozitive (răscumpărare QR), validarea sesiunii de dispozitiv, starea legării. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-PAIRING-0001` | 400 | cod de pairing necesar | `err.pairing.code_required` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-PAIRING-0002` | 401 | cod de pairing invalid sau expirat | `err.pairing.invalid_code` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-PAIRING-0003` | 401 | secret de intrare greșit | `err.pairing.bad_inbound_secret` | Credențiale lipsă sau invalide. | | `AIH-PAIRING-0004` | 400 | lipsește un câmp obligatoriu | `err.pairing.field_required` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-PAIRING-0005` | 401 | sesiune invalidă sau expirată | `err.pairing.session_invalid` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-PAIRING-0006` | 400 | token necesar | `err.pairing.token_required` | Intrare de cerere malformată, incompletă sau invalidă. | ## MARKETPLACE Calea de instalare din marketplace-ul de pluginuri: slug-ul este validat împotriva catalogului înainte de deploy-ul asincron. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | modul necunoscut: nu este în catalog | `err.marketplace.unknown_module` | Obiectul referit nu există sau este în afara domeniului. | ## LLM Fluxul de autorizare prin dispozitiv „Connect Codex (abonament ChatGPT)” din produs. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | conectarea Codex este indisponibilă: vault-ul de secrete (AIHUMMER_MASTER_KEY) nu este configurat | `err.llm.codex_connect_disabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-LLM-0002` | 502 | nu s-a putut porni fluxul de autorizare prin dispozitiv Codex | `err.llm.codex_connect_start_failed` | Un apel upstream/furnizor a eșuat. | | `AIH-LLM-0003` | 500 | nu s-a putut șterge conexiunea Codex stocată | `err.llm.codex_disconnect_failed` | Un eșec intern neașteptat. | ## AGENT CRUD pentru AI-angajat (agent), versiuni, clonare și profilul de system-prompt per agent. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-AGENT-0001` | 501 | agenții nu sunt activați | `err.agent.not_enabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-AGENT-0002` | 404 | agent negăsit | `err.agent.not_found` | Obiectul referit nu există sau este în afara domeniului. | | `AIH-AGENT-0003` | 403 | nu este agentul tău | `err.agent.forbidden` | Resursa aparține altui chiriaș/proprietar/sesiune. | | `AIH-AGENT-0004` | 501 | profilurile de agent nu sunt activate | `err.agent.profile_not_enabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-AGENT-0005` | 404 | secțiune partajată negăsită | `err.agent.section_not_found` | Obiectul referit nu există sau este în afara domeniului. | | `AIH-AGENT-0006` | 403 | nu este secțiunea ta partajată | `err.agent.section_forbidden` | Resursa aparține altui chiriaș/proprietar/sesiune. | | `AIH-AGENT-0007` | 400 | tip de secțiune necunoscut | `err.agent.unknown_section_kind` | Intrare de cerere malformată, incompletă sau invalidă. | ## APPROVAL Coadă de aprobare human-in-the-loop: funcționalitatea de aprobare este dezactivată. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | aprobările nu sunt activate | `err.approval.not_enabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | ## ARTIFACT Artefacte de conversație (documente + cod executabil): code-exec dezactivat, artefact/versiune lipsă, tip greșit sau ieșire de runner invalidă. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-ARTIFACT-0001` | 501 | execuția de cod nu este activată | `err.artifact.exec_disabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-ARTIFACT-0002` | 404 | artefact negăsit | `err.artifact.not_found` | Obiectul referit nu există sau este în afara domeniului. | | `AIH-ARTIFACT-0003` | 404 | versiune de artefact negăsită | `err.artifact.version_not_found` | Obiectul referit nu există sau este în afara domeniului. | | `AIH-ARTIFACT-0004` | 400 | artefactul nu este cod | `err.artifact.not_code` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-ARTIFACT-0005` | 500 | ieșire de runner invalidă | `err.artifact.bad_runner_output` | Un eșec intern neașteptat. | | `AIH-ARTIFACT-0006` | 400 | tipul trebuie să fie document sau cod | `err.artifact.invalid_kind` | Intrare de cerere malformată, incompletă sau invalidă. | ## CHAT Endpoint de chat-completions compatibil cu OpenAI. Forma pe fir rămâne compatibilă cu OpenAI, adăugând în plus un cod stabil. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | endpointul compatibil openai este dezactivat | `err.chat.disabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-CHAT-0002` | 401 | cheie api invalidă | `err.chat.invalid_key` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-CHAT-0003` | 400 | cerere de chat invalidă | `err.chat.invalid_request` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-CHAT-0004` | 429 | limită de rată sau de buget depășită | `err.chat.rate_limited` | Prea multe cereri / peste bugetul configurat. | | `AIH-CHAT-0005` | 502 | tura de chat a eșuat | `err.chat.turn_failed` | Un apel upstream/furnizor a eșuat. | | `AIH-CHAT-0006` | 500 | chat completion a eșuat | `err.chat.internal` | Un eșec intern neașteptat. | ## INBOUND Endpointuri generice de webhook/ingest de intrare: ingestia mesajelor canal→gateway. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | neautorizat | `err.inbound.unauthorized` | Credențiale lipsă sau invalide. | | `AIH-INBOUND-0002` | 400 | payload de intrare invalid | `err.inbound.invalid_payload` | Intrare de cerere malformată, incompletă sau invalidă. | | `AIH-INBOUND-0003` | 500 | dispecerizarea de intrare a eșuat | `err.inbound.dispatch_failed` | Un eșec intern neașteptat. | ## KB Conectori pentru baza de cunoștințe: funcționalitatea RAG dezactivată, configurație de conector stocată coruptă sau o arhivă încărcată greșită. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-KB-0001` | 501 | baza de cunoștințe nu este activată | `err.kb.not_enabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-KB-0002` | 500 | configurația stocată este coruptă | `err.kb.config_corrupt` | Un eșec intern neașteptat. | | `AIH-KB-0003` | 400 | arhivă de cunoștințe invalidă | `err.kb.invalid_archive` | Intrare de cerere malformată, incompletă sau invalidă. | ## MEDIA Endpointuri de fetch/stream pentru blob-uri media: acces media cu token semnat. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | media negăsit | `err.media.not_found` | Obiectul referit nu există sau este în afara domeniului. | | `AIH-MEDIA-0002` | 403 | token media invalid sau expirat | `err.media.token_invalid` | Resursa aparține altui chiriaș/proprietar/sesiune. | ## MEMORY Suprafața de administrare a memoriei pe termen lung (Einstein): backend-ul de memorie nu este conectat. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | memoria nu este configurată | `err.memory.not_configured` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | ## MODULE Suprafața de control a marketplace-ului de pluginuri/module: funcționalitate dezactivată, sursă/instalare lipsă, proprietate sau o încărcare laterală malformată. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | marketplace-ul nu este activat | `err.module.not_enabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-MODULE-0002` | 404 | sursă negăsită | `err.module.source_not_found` | Obiectul referit nu există sau este în afara domeniului. | | `AIH-MODULE-0003` | 404 | instalare negăsită | `err.module.installation_not_found` | Obiectul referit nu există sau este în afara domeniului. | | `AIH-MODULE-0004` | 403 | nu este instalarea ta | `err.module.installation_forbidden` | Resursa aparține altui chiriaș/proprietar/sesiune. | | `AIH-MODULE-0005` | 501 | încărcarea de pluginuri este dezactivată (fără stocare de blob-uri) | `err.module.upload_disabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-MODULE-0006` | 400 | pachet de încărcare de plugin invalid | `err.module.invalid_bundle` | Intrare de cerere malformată, incompletă sau invalidă. | ## SECRET Vault de secrete per chiriaș: cheia master lipsește sau secretul numit nu există. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | secretele nu sunt configurate | `err.secret.not_configured` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-SECRET-0002` | 404 | secret negăsit | `err.secret.not_found` | Obiectul referit nu există sau este în afara domeniului. | ## SESSION Suprafața de administrare conversație/sesiune + mesaj: funcționalitate dezactivată sau conversația/mesajul nu aparține apelantului. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-SESSION-0001` | 501 | conversațiile nu sunt activate | `err.session.not_enabled` | Funcționalitatea/integrarea este dezactivată sau neconfigurată. | | `AIH-SESSION-0002` | 403 | nu este conversația ta | `err.session.conversation_forbidden` | Resursa aparține altui chiriaș/proprietar/sesiune. | | `AIH-SESSION-0003` | 403 | nu este mesajul tău | `err.session.message_forbidden` | Resursa aparține altui chiriaș/proprietar/sesiune. | ## VOICE Endpointul de tură vocală (/v1/voice/turn): suprafața de tură audio puntea SIP → gateway. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | nu s-a putut rezolva conversația | `err.voice.resolve_failed` | Un apel upstream/furnizor a eșuat. | | `AIH-VOICE-0002` | 502 | tura vocală a eșuat | `err.voice.turn_failed` | Un apel upstream/furnizor a eșuat. | ## WEBCONN Conector de widget de chat web încorporabil: sesiune de browser + chat SSE. Evenimentele de eroare SSE în flux nu fac parte din acest plic. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | conversația nu aparține sesiunii tale | `err.webconn.forbidden` | Resursa aparține altui chiriaș/proprietar/sesiune. | | `AIH-WEBCONN-0002` | 500 | streaming neacceptat | `err.webconn.streaming_unsupported` | Un eșec intern neașteptat. | ## WORKSPACE Proprietatea/domeniul spațiului de lucru: chiriașul care acționează a acționat asupra unui spațiu de lucru care nu îi aparține. | Cod | HTTP | Semnificație | cheie i18n | Cauză tipică | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | nu este spațiul tău de lucru | `err.workspace.forbidden` | Resursa aparține altui chiriaș/proprietar/sesiune. |