Xato kodlari

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

Har bir AiHummer API xatosi `AIH-<DOMAIN>-<NNNN>` koʻrinishidagi **barqaror mashina kodi**ni olib yuradi. Wire shakli quyidagicha: ```json { "error": { "code": "AIH-AUTH-0001", "message": "invalid login or password", "message_key": "err.auth.invalid_credentials", "details": { } } } ``` `code` barqaror (hech qachon qayta ishlatilmaydi yoki qayta raqamlanmaydi); `message` — odam oʻqiy oladigan inglizcha satr; `message_key` — mijozlar lokalizatsiya qilish uchun ishlatadigan i18n kalit; `details` — ixtiyoriy strukturali kontekst. Kodlar `internal/apierr`'da yagona haqiqat manbaidir va bu sahifa oʻsha reestrni aks ettiradi. > Billing / reja-huquqlari xatolari (402 "yangilash talab qilinadi" yuzasi) bu yerda **roʻyxatlanmagan** — ular billing hujjatlarida tasvirlangan. ## COMMON Har bir xizmat tomonidan boʻlishiladigan kesishuvchi xatolar (soʻrov shakli, metod, autentifikatsiya, ichki nosozliklar). Mos kelganda domenga xos kod afzal koʻriladi. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-COMMON-0001` | 405 | metod ruxsat etilmagan | `err.common.method_not_allowed` | Bu marshrut uchun HTTP metodi ruxsat etilmagan. | | `AIH-COMMON-0002` | 400 | notoʻgʻri soʻrov tanasi | `err.common.invalid_body` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-COMMON-0003` | 400 | majburiy maydon yetishmayapti | `err.common.missing_field` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-COMMON-0004` | 500 | ichki xato | `err.common.internal` | Kutilmagan ichki nosozlik. | | `AIH-COMMON-0005` | 404 | topilmadi | `err.common.not_found` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | | `AIH-COMMON-0006` | 403 | taqiqlangan | `err.common.forbidden` | Kutilmagan ichki nosozlik. | | `AIH-COMMON-0007` | 501 | imkoniyat yoqilmagan | `err.common.not_enabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-COMMON-0008` | 401 | avtorizatsiyasiz | `err.common.unauthorized` | Hisob maʼlumotlari yoʻq yoki notoʻgʻri. | | `AIH-COMMON-0009` | 400 | tekshirish muvaffaqiyatsiz | `err.common.validation` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-COMMON-0010` | 409 | ziddiyat | `err.common.conflict` | Joriy holat bilan ziddiyatda. | | `AIH-COMMON-0011` | 429 | soʻrov chegarasi oshib ketdi | `err.common.rate_limited` | Juda koʻp soʻrovlar / sozlangan byudjetdan oshib ketgan. | | `AIH-COMMON-0012` | 502 | yuqori oqim xatosi | `err.common.upstream` | Yuqori oqimdagi/provayder chaqirigʻi muvaffaqiyatsiz boʻldi. | ## AUTH Admin mahalliy-autentifikatsiyasi: kirish, sessiyalar, parolni oʻzgartirish, foydalanuvchilarni boshqarish, 2FA. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-AUTH-0001` | 401 | notoʻgʻri login yoki parol | `err.auth.invalid_credentials` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-AUTH-0002` | 429 | juda koʻp urinish, keyinroq qayta urining | `err.auth.too_many_attempts` | Juda koʻp soʻrovlar / sozlangan byudjetdan oshib ketgan. | | `AIH-AUTH-0003` | 401 | autentifikatsiyadan oʻtmagan | `err.auth.not_authenticated` | Hisob maʼlumotlari yoʻq yoki notoʻgʻri. | | `AIH-AUTH-0004` | 501 | mahalliy autentifikatsiya yoqilmagan | `err.auth.local_disabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-AUTH-0005` | 403 | joriy parol notoʻgʻri | `err.auth.wrong_current_password` | Resurs boshqa ijarachi/egasi/sessiyaga tegishli. | | `AIH-AUTH-0006` | 409 | oʻz hisobingizni oʻchira olmaysiz | `err.auth.cannot_delete_self` | Joriy holat bilan ziddiyatda. | | `AIH-AUTH-0007` | 500 | sessiya yaratib boʻlmadi | `err.auth.session_failed` | Kutilmagan ichki nosozlik. | | `AIH-AUTH-0008` | 501 | ikki faktorli autentifikatsiya yoqilmagan | `err.auth.twofa_disabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-AUTH-0009` | 401 | chaqiruv muddati oʻtdi — qayta kiring | `err.auth.twofa_challenge_expired` | Hisob maʼlumotlari yoʻq yoki notoʻgʻri. | | `AIH-AUTH-0010` | 401 | notoʻgʻri kod | `err.auth.twofa_invalid_code` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-AUTH-0011` | 401 | notoʻgʻri tiklash kodi | `err.auth.twofa_invalid_recovery` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-AUTH-0012` | 401 | ikkinchi-faktor tekshiruvi muvaffaqiyatsiz | `err.auth.twofa_verify_failed` | Hisob maʼlumotlari yoʻq yoki notoʻgʻri. | | `AIH-AUTH-0013` | 400 | mos keladigan ikkinchi faktor roʻyxatdan oʻtkazilmagan | `err.auth.twofa_not_enrolled` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | ## PAIRING Qurilmani juftlash (QR ishlatish), qurilma-sessiyasini tekshirish, bogʻlanish holati. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-PAIRING-0001` | 400 | juftlash kodi talab qilinadi | `err.pairing.code_required` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-PAIRING-0002` | 401 | notoʻgʻri yoki muddati oʻtgan juftlash kodi | `err.pairing.invalid_code` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-PAIRING-0003` | 401 | notoʻgʻri kiruvchi sir | `err.pairing.bad_inbound_secret` | Hisob maʼlumotlari yoʻq yoki notoʻgʻri. | | `AIH-PAIRING-0004` | 400 | majburiy maydon yetishmayapti | `err.pairing.field_required` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-PAIRING-0005` | 401 | notoʻgʻri yoki muddati oʻtgan sessiya | `err.pairing.session_invalid` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-PAIRING-0006` | 400 | token talab qilinadi | `err.pairing.token_required` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | ## MARKETPLACE Plagin marketpleysida oʻrnatish yoʻli: async deploydan oldin slug katalogga qarshi tekshiriladi. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | nomaʼlum modul: katalogda yoʻq | `err.marketplace.unknown_module` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | ## LLM Mahsulot ichidagi "Codex'ni ulash (ChatGPT obunasi)" qurilma-avtorizatsiya oqimi. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex ulanishi mavjud emas: sirlar vaulti (AIHUMMER_MASTER_KEY) sozlanmagan | `err.llm.codex_connect_disabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-LLM-0002` | 502 | Codex qurilma-avtorizatsiya oqimini boshlab boʻlmadi | `err.llm.codex_connect_start_failed` | Yuqori oqimdagi/provayder chaqirigʻi muvaffaqiyatsiz boʻldi. | | `AIH-LLM-0003` | 500 | saqlangan Codex ulanishini tozalab boʻlmadi | `err.llm.codex_disconnect_failed` | Kutilmagan ichki nosozlik. | ## AGENT AI-xodim (agent) CRUD, versiyalar, klonlash va har bir agent uchun tizim-prompt profili. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-AGENT-0001` | 501 | agentlar yoqilmagan | `err.agent.not_enabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-AGENT-0002` | 404 | agent topilmadi | `err.agent.not_found` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | | `AIH-AGENT-0003` | 403 | sizning agentingiz emas | `err.agent.forbidden` | Resurs boshqa ijarachi/egasi/sessiyaga tegishli. | | `AIH-AGENT-0004` | 501 | agent profillari yoqilmagan | `err.agent.profile_not_enabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-AGENT-0005` | 404 | boʻlishilgan boʻlim topilmadi | `err.agent.section_not_found` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | | `AIH-AGENT-0006` | 403 | sizning boʻlishilgan boʻlimingiz emas | `err.agent.section_forbidden` | Resurs boshqa ijarachi/egasi/sessiyaga tegishli. | | `AIH-AGENT-0007` | 400 | nomaʼlum boʻlim turi | `err.agent.unknown_section_kind` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | ## APPROVAL Inson tasdiqi (human-in-the-loop) navbati: tasdiqlash imkoniyati oʻchirilgan. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | tasdiqlashlar yoqilmagan | `err.approval.not_enabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | ## ARTIFACT Suhbat artefaktlari (hujjatlar + ishga tushiriladigan kod): code-exec oʻchirilgan, artefakt/versiya yetishmayapti, notoʻgʻri tur yoki notoʻgʻri runner chiqishi. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-ARTIFACT-0001` | 501 | kodni bajarish yoqilmagan | `err.artifact.exec_disabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-ARTIFACT-0002` | 404 | artefakt topilmadi | `err.artifact.not_found` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | | `AIH-ARTIFACT-0003` | 404 | artefakt versiyasi topilmadi | `err.artifact.version_not_found` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | | `AIH-ARTIFACT-0004` | 400 | artefakt kod emas | `err.artifact.not_code` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-ARTIFACT-0005` | 500 | notoʻgʻri runner chiqishi | `err.artifact.bad_runner_output` | Kutilmagan ichki nosozlik. | | `AIH-ARTIFACT-0006` | 400 | tur hujjat yoki kod boʻlishi kerak | `err.artifact.invalid_kind` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | ## CHAT OpenAI bilan mos chat-completions endpoint'i. Wire shakli OpenAI bilan mos qoladi, ammo barqaror kod qoʻshiladi. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | openai bilan mos endpoint oʻchirilgan | `err.chat.disabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-CHAT-0002` | 401 | notoʻgʻri api kaliti | `err.chat.invalid_key` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-CHAT-0003` | 400 | notoʻgʻri chat soʻrovi | `err.chat.invalid_request` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-CHAT-0004` | 429 | soʻrov yoki byudjet chegarasi oshib ketdi | `err.chat.rate_limited` | Juda koʻp soʻrovlar / sozlangan byudjetdan oshib ketgan. | | `AIH-CHAT-0005` | 502 | chat turn'i muvaffaqiyatsiz | `err.chat.turn_failed` | Yuqori oqimdagi/provayder chaqirigʻi muvaffaqiyatsiz boʻldi. | | `AIH-CHAT-0006` | 500 | chat completion muvaffaqiyatsiz | `err.chat.internal` | Kutilmagan ichki nosozlik. | ## INBOUND Umumiy kiruvchi webhook/ingest endpoint'lari: kanal→gateway xabarlarini qabul qilish. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | avtorizatsiyasiz | `err.inbound.unauthorized` | Hisob maʼlumotlari yoʻq yoki notoʻgʻri. | | `AIH-INBOUND-0002` | 400 | notoʻgʻri kiruvchi yuk | `err.inbound.invalid_payload` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | | `AIH-INBOUND-0003` | 500 | kiruvchi dispetcheri muvaffaqiyatsiz | `err.inbound.dispatch_failed` | Kutilmagan ichki nosozlik. | ## KB Bilim-bazasi konnektorlari: RAG imkoniyati oʻchirilgan, saqlangan konnektor konfiguratsiyasi buzilgan yoki yuklangan arxiv notoʻgʻri. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-KB-0001` | 501 | bilim bazasi yoqilmagan | `err.kb.not_enabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-KB-0002` | 500 | saqlangan konfiguratsiya buzilgan | `err.kb.config_corrupt` | Kutilmagan ichki nosozlik. | | `AIH-KB-0003` | 400 | notoʻgʻri bilim arxivi | `err.kb.invalid_archive` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | ## MEDIA Media blob olish/oqim endpoint'lari: imzolangan-token bilan mediaga kirish. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | media topilmadi | `err.media.not_found` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | | `AIH-MEDIA-0002` | 403 | notoʻgʻri yoki muddati oʻtgan media tokeni | `err.media.token_invalid` | Resurs boshqa ijarachi/egasi/sessiyaga tegishli. | ## MEMORY Uzoq muddatli xotira (Einstein) admin yuzasi: xotira backend'i ulanmagan. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | xotira sozlanmagan | `err.memory.not_configured` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | ## MODULE Plagin/modul marketpleysi boshqaruv yuzasi: imkoniyat oʻchirilgan, manba/oʻrnatish yetishmayapti, egalik yoki notoʻgʻri side-load yuklash. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | marketpleys yoqilmagan | `err.module.not_enabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-MODULE-0002` | 404 | manba topilmadi | `err.module.source_not_found` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | | `AIH-MODULE-0003` | 404 | oʻrnatish topilmadi | `err.module.installation_not_found` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | | `AIH-MODULE-0004` | 403 | sizning oʻrnatishingiz emas | `err.module.installation_forbidden` | Resurs boshqa ijarachi/egasi/sessiyaga tegishli. | | `AIH-MODULE-0005` | 501 | plagin yuklash oʻchirilgan (blob ombori yoʻq) | `err.module.upload_disabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-MODULE-0006` | 400 | notoʻgʻri plagin yuklash to'plami | `err.module.invalid_bundle` | Buzilgan, toʻliq boʻlmagan yoki notoʻgʻri soʻrov kiritmasi. | ## SECRET Har bir ijarachi uchun sirlar vaulti: master kalit yoʻq yoki nomlangan sir mavjud emas. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | sirlar sozlanmagan | `err.secret.not_configured` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-SECRET-0002` | 404 | sir topilmadi | `err.secret.not_found` | Havola qilingan obyekt mavjud emas yoki qamrov tashqarisida. | ## SESSION Suhbat/sessiya + xabar admin yuzasi: imkoniyat oʻchirilgan yoki suhbat/xabar chaqiruvchiga tegishli emas. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-SESSION-0001` | 501 | suhbatlar yoqilmagan | `err.session.not_enabled` | Imkoniyat/integratsiya oʻchirilgan yoki sozlanmagan. | | `AIH-SESSION-0002` | 403 | sizning suhbatingiz emas | `err.session.conversation_forbidden` | Resurs boshqa ijarachi/egasi/sessiyaga tegishli. | | `AIH-SESSION-0003` | 403 | sizning xabaringiz emas | `err.session.message_forbidden` | Resurs boshqa ijarachi/egasi/sessiyaga tegishli. | ## VOICE Ovozli turn endpoint'i (/v1/voice/turn): SIP-koʻprigi → gateway audio-turn yuzasi. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | suhbatni aniqlab boʻlmadi | `err.voice.resolve_failed` | Yuqori oqimdagi/provayder chaqirigʻi muvaffaqiyatsiz boʻldi. | | `AIH-VOICE-0002` | 502 | ovozli turn muvaffaqiyatsiz | `err.voice.turn_failed` | Yuqori oqimdagi/provayder chaqirigʻi muvaffaqiyatsiz boʻldi. | ## WEBCONN Joylashtiriladigan veb-chat vidjet konnektori: brauzer sessiyasi + SSE chat. Oqimli SSE xato hodisalari ushbu konvertning qismi emas. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | suhbat sizning sessiyangizga tegishli emas | `err.webconn.forbidden` | Resurs boshqa ijarachi/egasi/sessiyaga tegishli. | | `AIH-WEBCONN-0002` | 500 | oqim qoʻllab-quvvatlanmaydi | `err.webconn.streaming_unsupported` | Kutilmagan ichki nosozlik. | ## WORKSPACE Ish maydoni egaligi/qamrovi: harakat qiluvchi ijarachi oʻziga tegishli boʻlmagan ish maydoniga taʼsir koʻrsatdi. | Code | HTTP | Maʼnosi | i18n key | Odatiy sabab | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | sizning ish maydoningiz emas | `err.workspace.forbidden` | Resurs boshqa ijarachi/egasi/sessiyaga tegishli. |