Ýalňyş kodlary

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

Her AiHummer API ýalňyşy `AIH-<DOMAIN>-<NNNN>` görnüşinde **durnukly maşyn kody** göterýär. Wire şekili: ```json { "error": { "code": "AIH-AUTH-0001", "message": "invalid login or password", "message_key": "err.auth.invalid_credentials", "details": { } } } ``` `code` durnukly (hiç haçan gaýtadan ulanylmaýar ýa-da gaýtadan belgilenmeýär); `message` adam iňlis setiri; `message_key` müşderiler lokallaşdyrmak üçin ulanýan i18n açarydyr; `details` islege bagly gurluşly kontekst. Kodlar `internal/apierr`-de hakykatyň ýeke-täk çeşmesidir we bu sahypa şol registri şöhlelendirýär. > Hasaplaşyk / plan-hukuk ýalňyşlary (402 "upgrade required" üsti) bu ýerde **sanalmaýar** — olar hasaplaşyk dokumentlerinde resmileşdirilen. ## COMMON Her hyzmat tarapyndan paýlaşylan kese-kesişýän ýalňyşlar (haýyş şekili, metod, awtentifikasiýa, içki näsazlyklar). Gabat geleni bar bolsa domene-mahsus kod ileri tutulýar. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-COMMON-0001` | 405 | metod rugsat berilmedik | `err.common.method_not_allowed` | HTTP metody bu marşrut üçin rugsat berilmeýär. | | `AIH-COMMON-0002` | 400 | nädogry haýyş bedeni | `err.common.invalid_body` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-COMMON-0003` | 400 | talap edilýän meýdan ýitirim | `err.common.missing_field` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-COMMON-0004` | 500 | içki ýalňyş | `err.common.internal` | Garaşylmadyk içki näsazlyk. | | `AIH-COMMON-0005` | 404 | tapylmady | `err.common.not_found` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | | `AIH-COMMON-0006` | 403 | gadagan | `err.common.forbidden` | Garaşylmadyk içki näsazlyk. | | `AIH-COMMON-0007` | 501 | funksiýa işjeňleşdirilmedik | `err.common.not_enabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-COMMON-0008` | 401 | awtorizasiýa edilmedik | `err.common.unauthorized` | Ýitirim ýa-da nädogry kredensiallar. | | `AIH-COMMON-0009` | 400 | walidasiýa şowsuz | `err.common.validation` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-COMMON-0010` | 409 | gapma-garşylyk | `err.common.conflict` | Häzirki ýagdaý bilen gapma-garşy gelýär. | | `AIH-COMMON-0011` | 429 | tizlik çägi aşyldy | `err.common.rate_limited` | Aşa köp haýyş / düzülen býujetden ýokary. | | `AIH-COMMON-0012` | 502 | ýokary akym ýalňyşy | `err.common.upstream` | Ýokary akym/üpjün ediji çagyryşy şowsuz boldy. | ## AUTH Admin lokal-awtentifikasiýa: login, sessiýalar, parol üýtgetmek, ulanyjy dolandyrmak, 2FA. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-AUTH-0001` | 401 | nädogry login ýa-da parol | `err.auth.invalid_credentials` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-AUTH-0002` | 429 | aşa köp synanyşyk, soňra synanyşyň | `err.auth.too_many_attempts` | Aşa köp haýyş / düzülen býujetden ýokary. | | `AIH-AUTH-0003` | 401 | awtentifikasiýa edilmedik | `err.auth.not_authenticated` | Ýitirim ýa-da nädogry kredensiallar. | | `AIH-AUTH-0004` | 501 | lokal awtentifikasiýa işjeňleşdirilmedik | `err.auth.local_disabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-AUTH-0005` | 403 | häzirki parol nädogry | `err.auth.wrong_current_password` | Resurs başga tenant/eýe/sessiýa degişli. | | `AIH-AUTH-0006` | 409 | öz hasabyňyzy pozup bilmeýärsiňiz | `err.auth.cannot_delete_self` | Häzirki ýagdaý bilen gapma-garşy gelýär. | | `AIH-AUTH-0007` | 500 | sessiýa döredip bolmady | `err.auth.session_failed` | Garaşylmadyk içki näsazlyk. | | `AIH-AUTH-0008` | 501 | iki-faktorly awtentifikasiýa işjeňleşdirilmedik | `err.auth.twofa_disabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-AUTH-0009` | 401 | çagyryş möhleti gutardy — täzeden giriň | `err.auth.twofa_challenge_expired` | Ýitirim ýa-da nädogry kredensiallar. | | `AIH-AUTH-0010` | 401 | nädogry kod | `err.auth.twofa_invalid_code` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-AUTH-0011` | 401 | nädogry dikeldiş kody | `err.auth.twofa_invalid_recovery` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-AUTH-0012` | 401 | ikinji-faktor barlamasy şowsuz | `err.auth.twofa_verify_failed` | Ýitirim ýa-da nädogry kredensiallar. | | `AIH-AUTH-0013` | 400 | gabat gelýän ikinji faktor hasaba alynmadyk | `err.auth.twofa_not_enrolled` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | ## PAIRING Enjam jübütleşdirmek (QR ulanmak), enjam-sessiýa walidasiýasy, baglanyşyk ýagdaýy. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-PAIRING-0001` | 400 | jübütleşdiriş kody gerek | `err.pairing.code_required` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-PAIRING-0002` | 401 | nädogry ýa-da möhleti gutaran jübütleşdiriş kody | `err.pairing.invalid_code` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-PAIRING-0003` | 401 | erbet gelýän syr | `err.pairing.bad_inbound_secret` | Ýitirim ýa-da nädogry kredensiallar. | | `AIH-PAIRING-0004` | 400 | talap edilýän meýdan ýitirim | `err.pairing.field_required` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-PAIRING-0005` | 401 | nädogry ýa-da möhleti gutaran sessiýa | `err.pairing.session_invalid` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-PAIRING-0006` | 400 | token gerek | `err.pairing.token_required` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | ## MARKETPLACE Plugin marketpleýs gurnama ýoly: slug asinhron ýerleşdirişden öň kataloga garşy barlanýar. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | näbelli modul: katalogda ýok | `err.marketplace.unknown_module` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | ## LLM Önümiň içindäki "Connect Codex (ChatGPT abonementi)" enjam-awtorizasiýa akymy. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex connect elýeterli däl: syrlar ammary (AIHUMMER_MASTER_KEY) düzülmedik | `err.llm.codex_connect_disabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-LLM-0002` | 502 | Codex enjam-awtorizasiýa akymyny başladyp bolmady | `err.llm.codex_connect_start_failed` | Ýokary akym/üpjün ediji çagyryşy şowsuz boldy. | | `AIH-LLM-0003` | 500 | saklanan Codex birikmesini arassalap bolmady | `err.llm.codex_disconnect_failed` | Garaşylmadyk içki näsazlyk. | ## AGENT AI-işgär (agent) CRUD, wersiýalar, klon we her-agent ulgam-prompt profili. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-AGENT-0001` | 501 | agentler işjeňleşdirilmedik | `err.agent.not_enabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-AGENT-0002` | 404 | agent tapylmady | `err.agent.not_found` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | | `AIH-AGENT-0003` | 403 | siziň agentiňiz däl | `err.agent.forbidden` | Resurs başga tenant/eýe/sessiýa degişli. | | `AIH-AGENT-0004` | 501 | agent profilleri işjeňleşdirilmedik | `err.agent.profile_not_enabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-AGENT-0005` | 404 | paýlaşylan bölüm tapylmady | `err.agent.section_not_found` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | | `AIH-AGENT-0006` | 403 | siziň paýlaşylan bölümiňiz däl | `err.agent.section_forbidden` | Resurs başga tenant/eýe/sessiýa degişli. | | `AIH-AGENT-0007` | 400 | näbelli bölüm görnüşi | `err.agent.unknown_section_kind` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | ## APPROVAL Human-in-the-loop tassyklama nobaty: tassyklama funksiýasy öçük. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | tassyklamalar işjeňleşdirilmedik | `err.approval.not_enabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | ## ARTIFACT Söhbetdeşlik artefaktlary (resminamalar + işledilýän kod): code-exec öçük, ýitirim artefakt/wersiýa, nädogry görnüş ýa-da erbet işlediji çykyşy. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-ARTIFACT-0001` | 501 | kod ýerine ýetiriş işjeňleşdirilmedik | `err.artifact.exec_disabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-ARTIFACT-0002` | 404 | artefakt tapylmady | `err.artifact.not_found` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | | `AIH-ARTIFACT-0003` | 404 | artefakt wersiýasy tapylmady | `err.artifact.version_not_found` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | | `AIH-ARTIFACT-0004` | 400 | artefakt kod däl | `err.artifact.not_code` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-ARTIFACT-0005` | 500 | erbet işlediji çykyşy | `err.artifact.bad_runner_output` | Garaşylmadyk içki näsazlyk. | | `AIH-ARTIFACT-0006` | 400 | görnüş resminama ýa-da kod bolmaly | `err.artifact.invalid_kind` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | ## CHAT OpenAI-uýgun chat-completions endpointi. Wire şekili durnukly kod goşulanda-da OpenAI-uýgun bolup galýar. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | openai-uýgun endpoint öçürilen | `err.chat.disabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-CHAT-0002` | 401 | nädogry api açary | `err.chat.invalid_key` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-CHAT-0003` | 400 | nädogry çat haýyşy | `err.chat.invalid_request` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-CHAT-0004` | 429 | tizlik ýa-da býujet çägi aşyldy | `err.chat.rate_limited` | Aşa köp haýyş / düzülen býujetden ýokary. | | `AIH-CHAT-0005` | 502 | çat gezegi şowsuz | `err.chat.turn_failed` | Ýokary akym/üpjün ediji çagyryşy şowsuz boldy. | | `AIH-CHAT-0006` | 500 | çat tamamlamasy şowsuz | `err.chat.internal` | Garaşylmadyk içki näsazlyk. | ## INBOUND Umumy gelýän webhook/kabul ediş endpointleri: kanal→geýtweý habar kabul etmesi. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | awtorizasiýa edilmedik | `err.inbound.unauthorized` | Ýitirim ýa-da nädogry kredensiallar. | | `AIH-INBOUND-0002` | 400 | nädogry gelýän ýük | `err.inbound.invalid_payload` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | | `AIH-INBOUND-0003` | 500 | gelýän ugratma şowsuz | `err.inbound.dispatch_failed` | Garaşylmadyk içki näsazlyk. | ## KB Bilim-bazasy konnektorlary: RAG funksiýasy öçük, saklanan konnektor konfigi bozuk ýa-da erbet ýüklenen arhiw. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-KB-0001` | 501 | bilim bazasy işjeňleşdirilmedik | `err.kb.not_enabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-KB-0002` | 500 | saklanan konfig bozuk | `err.kb.config_corrupt` | Garaşylmadyk içki näsazlyk. | | `AIH-KB-0003` | 400 | nädogry bilim arhiwi | `err.kb.invalid_archive` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | ## MEDIA Media blob alyş/strim endpointleri: imzalanan-token media elýeterligi. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | media tapylmady | `err.media.not_found` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | | `AIH-MEDIA-0002` | 403 | nädogry ýa-da möhleti gutaran media tokeni | `err.media.token_invalid` | Resurs başga tenant/eýe/sessiýa degişli. | ## MEMORY Uzak möhletli ýat (Einstein) admin üsti: ýat backendi birikdirilmedik. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | ýat düzülmedik | `err.memory.not_configured` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | ## MODULE Plugin/modul marketpleýs dolandyryş üsti: funksiýa öçük, ýitirim çeşme/gurnama, eýelik ýa-da bozuk side-load ýüklemesi. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | marketpleýs işjeňleşdirilmedik | `err.module.not_enabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-MODULE-0002` | 404 | çeşme tapylmady | `err.module.source_not_found` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | | `AIH-MODULE-0003` | 404 | gurnama tapylmady | `err.module.installation_not_found` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | | `AIH-MODULE-0004` | 403 | siziň gurnamaňyz däl | `err.module.installation_forbidden` | Resurs başga tenant/eýe/sessiýa degişli. | | `AIH-MODULE-0005` | 501 | plugin ýüklemesi öçürilen (blob ammary ýok) | `err.module.upload_disabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-MODULE-0006` | 400 | nädogry plugin ýükleme paketi | `err.module.invalid_bundle` | Bozuk, doly däl ýa-da nädogry haýyş girişi. | ## SECRET Her-tenant syr ammary: master açar ýok ýa-da atlandyrylan syr ýok. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | syrlar düzülmedik | `err.secret.not_configured` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-SECRET-0002` | 404 | syr tapylmady | `err.secret.not_found` | Salgylanan obýekt ýok ýa-da gerimden daşarda. | ## SESSION Söhbetdeşlik/sessiýa + habar admin üsti: funksiýa öçük ýa-da söhbetdeşlik/habar çagyryjynyňky däl. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-SESSION-0001` | 501 | söhbetdeşlikler işjeňleşdirilmedik | `err.session.not_enabled` | Funksiýa/integrasiýa öçürilen ýa-da düzülmedik. | | `AIH-SESSION-0002` | 403 | siziň söhbetdeşligiňiz däl | `err.session.conversation_forbidden` | Resurs başga tenant/eýe/sessiýa degişli. | | `AIH-SESSION-0003` | 403 | siziň habaryňyz däl | `err.session.message_forbidden` | Resurs başga tenant/eýe/sessiýa degişli. | ## VOICE Ses gezek endpointi (/v1/voice/turn): SIP-köpri → geýtweý audio-gezek üsti. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | söhbetdeşligi çözüp bolmady | `err.voice.resolve_failed` | Ýokary akym/üpjün ediji çagyryşy şowsuz boldy. | | `AIH-VOICE-0002` | 502 | ses gezegi şowsuz | `err.voice.turn_failed` | Ýokary akym/üpjün ediji çagyryşy şowsuz boldy. | ## WEBCONN Ýerleşdirilýän web-çat widget konnektory: brauzer sessiýasy + SSE çat. Strimleýän SSE ýalňyş wakalary bu örtügiň bir bölegi däl. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | söhbetdeşlik siziň sessiýaňyza degişli däl | `err.webconn.forbidden` | Resurs başga tenant/eýe/sessiýa degişli. | | `AIH-WEBCONN-0002` | 500 | strimleme goldanmaýar | `err.webconn.streaming_unsupported` | Garaşylmadyk içki näsazlyk. | ## WORKSPACE Işiş-meýdany eýeligi/gerimlemesi: hereket edýän tenant özüne degişli däl işiş-meýdanyna hereket etdi. | Kod | HTTP | Manysy | i18n açary | Adaty sebäp | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | siziň işiş-meýdanyňyz däl | `err.workspace.forbidden` | Resurs başga tenant/eýe/sessiýa degişli. |