Ката коддору

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

Ар бир AiHummer API катасы `AIH-<DOMAIN>-<NNNN>` формасында **туруктуу машина кодун** алып жүрөт. Зымдык формасы: ```json { "error": { "code": "AIH-AUTH-0001", "message": "invalid login or password", "message_key": "err.auth.invalid_credentials", "details": { } } } ``` `code` туруктуу (эч качан кайра колдонулбайт же кайра номерленбейт); `message` — адамга арналган англисче сап; `message_key` — клиенттер локалдаштыруу үчүн колдонгон i18n ачкычы; `details` — милдеттүү эмес түзүмдөшкөн контекст. Коддор `internal/apierr` ичиндеги бирден-бир чындык булагы жана бул бет ошол реестрди чагылдырат. > Биллинг / план-укуктар каталары (402 "upgrade required" бети) бул жерде **тизмеленбейт** — алар биллинг документтеринде сүрөттөлгөн. ## COMMON Ар бир кызмат бөлүшкөн кесилишкен каталар (суроо-талап формасы, метод, аутентификация, ички каталар). Дал келгенде доменге-тиешелүү код артык көрүлөт. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-COMMON-0001` | 405 | метод уруксат берилген эмес | `err.common.method_not_allowed` | HTTP методу бул маршрут үчүн уруксат берилген эмес. | | `AIH-COMMON-0002` | 400 | жараксыз суроо денеси | `err.common.invalid_body` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-COMMON-0003` | 400 | милдеттүү талаа жок | `err.common.missing_field` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-COMMON-0004` | 500 | ички ката | `err.common.internal` | Күтүлбөгөн ички бузулуу. | | `AIH-COMMON-0005` | 404 | табылган жок | `err.common.not_found` | Шилтемеленген объект жок же көлөмдөн тышкары. | | `AIH-COMMON-0006` | 403 | тыюу салынган | `err.common.forbidden` | Күтүлбөгөн ички бузулуу. | | `AIH-COMMON-0007` | 501 | мүмкүнчүлүк иштетилген эмес | `err.common.not_enabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-COMMON-0008` | 401 | авторизацияланган эмес | `err.common.unauthorized` | Жок же жараксыз эсептик дайындар. | | `AIH-COMMON-0009` | 400 | текшерүү ишке ашкан жок | `err.common.validation` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-COMMON-0010` | 409 | конфликт | `err.common.conflict` | Учурдагы абал менен конфликт. | | `AIH-COMMON-0011` | 429 | ылдамдык чеги ашты | `err.common.rate_limited` | Өтө көп суроо / конфигурацияланган бюджеттен ашык. | | `AIH-COMMON-0012` | 502 | upstream катасы | `err.common.upstream` | Upstream/провайдер чакырыгы ишке ашкан жок. | ## AUTH Админ жергиликтүү-аутентификация: кирүү, сессиялар, сырсөз алмаштыруу, колдонуучу башкаруу, 2FA. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-AUTH-0001` | 401 | жараксыз логин же сырсөз | `err.auth.invalid_credentials` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-AUTH-0002` | 429 | өтө көп аракет, кийинчерээк кайра аракет кылыңыз | `err.auth.too_many_attempts` | Өтө көп суроо / конфигурацияланган бюджеттен ашык. | | `AIH-AUTH-0003` | 401 | аутентификацияланган эмес | `err.auth.not_authenticated` | Жок же жараксыз эсептик дайындар. | | `AIH-AUTH-0004` | 501 | жергиликтүү аутентификация иштетилген эмес | `err.auth.local_disabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-AUTH-0005` | 403 | учурдагы сырсөз туура эмес | `err.auth.wrong_current_password` | Ресурс башка ижарачыга/ээсине/сессияга таандык. | | `AIH-AUTH-0006` | 409 | өзүңүздүн эсебиңизди өчүрө албайсыз | `err.auth.cannot_delete_self` | Учурдагы абал менен конфликт. | | `AIH-AUTH-0007` | 500 | сессия түзүлгөн жок | `err.auth.session_failed` | Күтүлбөгөн ички бузулуу. | | `AIH-AUTH-0008` | 501 | эки факторлуу аутентификация иштетилген эмес | `err.auth.twofa_disabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-AUTH-0009` | 401 | challenge мөөнөтү бүттү — кайра кириңиз | `err.auth.twofa_challenge_expired` | Жок же жараксыз эсептик дайындар. | | `AIH-AUTH-0010` | 401 | жараксыз код | `err.auth.twofa_invalid_code` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-AUTH-0011` | 401 | жараксыз калыбына келтирүү коду | `err.auth.twofa_invalid_recovery` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-AUTH-0012` | 401 | экинчи-фактор текшерүүсү ишке ашкан жок | `err.auth.twofa_verify_failed` | Жок же жараксыз эсептик дайындар. | | `AIH-AUTH-0013` | 400 | дал келген экинчи фактор каттоодон өткөн эмес | `err.auth.twofa_not_enrolled` | Бузук, толук эмес же жараксыз суроо кириши. | ## PAIRING Түзмөк жупташтыруу (QR redeem), түзмөк-сессияны текшерүү, байланыш статусу. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-PAIRING-0001` | 400 | жупташтыруу коду талап кылынат | `err.pairing.code_required` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-PAIRING-0002` | 401 | жараксыз же мөөнөтү бүткөн жупташтыруу коду | `err.pairing.invalid_code` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-PAIRING-0003` | 401 | туура эмес кируучу жашыруун | `err.pairing.bad_inbound_secret` | Жок же жараксыз эсептик дайындар. | | `AIH-PAIRING-0004` | 400 | милдеттүү талаа жок | `err.pairing.field_required` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-PAIRING-0005` | 401 | жараксыз же мөөнөтү бүткөн сессия | `err.pairing.session_invalid` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-PAIRING-0006` | 400 | token талап кылынат | `err.pairing.token_required` | Бузук, толук эмес же жараксыз суроо кириши. | ## MARKETPLACE Плагин marketplace орнотуу жолу: slug асинхрондук deploy'дон мурда каталогго каршы текшерилет. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | белгисиз модуль: каталогдо жок | `err.marketplace.unknown_module` | Шилтемеленген объект жок же көлөмдөн тышкары. | ## LLM Продукт ичиндеги "Connect Codex (ChatGPT subscription)" түзмөк-авторизация агымы. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex туташуу жеткиликсиз: жашыруундар vault'у (AIHUMMER_MASTER_KEY) конфигурацияланган эмес | `err.llm.codex_connect_disabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-LLM-0002` | 502 | Codex түзмөк-авторизация агымын баштоо мүмкүн болгон жок | `err.llm.codex_connect_start_failed` | Upstream/провайдер чакырыгы ишке ашкан жок. | | `AIH-LLM-0003` | 500 | сакталган Codex туташуусун тазалоо мүмкүн болгон жок | `err.llm.codex_disconnect_failed` | Күтүлбөгөн ички бузулуу. | ## AGENT AI-кызматкер (агент) CRUD, версиялар, клон, жана ар-агенттик система-промпт профили. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-AGENT-0001` | 501 | агенттер иштетилген эмес | `err.agent.not_enabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-AGENT-0002` | 404 | агент табылган жок | `err.agent.not_found` | Шилтемеленген объект жок же көлөмдөн тышкары. | | `AIH-AGENT-0003` | 403 | сиздин агентиңиз эмес | `err.agent.forbidden` | Ресурс башка ижарачыга/ээсине/сессияга таандык. | | `AIH-AGENT-0004` | 501 | агент профилдери иштетилген эмес | `err.agent.profile_not_enabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-AGENT-0005` | 404 | бөлүшүлгөн бөлүм табылган жок | `err.agent.section_not_found` | Шилтемеленген объект жок же көлөмдөн тышкары. | | `AIH-AGENT-0006` | 403 | сиздин бөлүшүлгөн бөлүмүңүз эмес | `err.agent.section_forbidden` | Ресурс башка ижарачыга/ээсине/сессияга таандык. | | `AIH-AGENT-0007` | 400 | белгисиз бөлүм түрү | `err.agent.unknown_section_kind` | Бузук, толук эмес же жараксыз суроо кириши. | ## APPROVAL Адамдын-катышуусу менен бекитүү кезеги: бекитүү мүмкүнчүлүгү өчүк. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | бекитүүлөр иштетилген эмес | `err.approval.not_enabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | ## ARTIFACT Маектешүү артефакттары (документтер + иштетилүүчү код): code-exec өчүк, артефакт/версия жок, туура эмес түр, же runner чыгаруусу туура эмес. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-ARTIFACT-0001` | 501 | код аткаруу иштетилген эмес | `err.artifact.exec_disabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-ARTIFACT-0002` | 404 | артефакт табылган жок | `err.artifact.not_found` | Шилтемеленген объект жок же көлөмдөн тышкары. | | `AIH-ARTIFACT-0003` | 404 | артефакт версиясы табылган жок | `err.artifact.version_not_found` | Шилтемеленген объект жок же көлөмдөн тышкары. | | `AIH-ARTIFACT-0004` | 400 | артефакт код эмес | `err.artifact.not_code` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-ARTIFACT-0005` | 500 | runner чыгаруусу туура эмес | `err.artifact.bad_runner_output` | Күтүлбөгөн ички бузулуу. | | `AIH-ARTIFACT-0006` | 400 | түрү document же code болушу керек | `err.artifact.invalid_kind` | Бузук, толук эмес же жараксыз суроо кириши. | ## CHAT OpenAI'га шайкеш chat-completions чекити. Зымдык форма OpenAI'га шайкеш бойдон калат, ага туруктуу код кошулат. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | openai'га шайкеш чекит өчүрүлгөн | `err.chat.disabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-CHAT-0002` | 401 | жараксыз api ачкычы | `err.chat.invalid_key` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-CHAT-0003` | 400 | жараксыз chat суроосу | `err.chat.invalid_request` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-CHAT-0004` | 429 | ылдамдык же бюджет чеги ашты | `err.chat.rate_limited` | Өтө көп суроо / конфигурацияланган бюджеттен ашык. | | `AIH-CHAT-0005` | 502 | chat кезеги ишке ашкан жок | `err.chat.turn_failed` | Upstream/провайдер чакырыгы ишке ашкан жок. | | `AIH-CHAT-0006` | 500 | chat completion ишке ашкан жок | `err.chat.internal` | Күтүлбөгөн ички бузулуу. | ## INBOUND Жалпы кируучу webhook/ingest чекиттери: канал→gateway кабар кабыл алуу. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | авторизацияланган эмес | `err.inbound.unauthorized` | Жок же жараксыз эсептик дайындар. | | `AIH-INBOUND-0002` | 400 | жараксыз кируучу payload | `err.inbound.invalid_payload` | Бузук, толук эмес же жараксыз суроо кириши. | | `AIH-INBOUND-0003` | 500 | кируучу диспетчер ишке ашкан жок | `err.inbound.dispatch_failed` | Күтүлбөгөн ички бузулуу. | ## KB Билим базасы коннекторлору: RAG мүмкүнчүлүгү өчүк, сакталган коннектор конфиги бузук, же жүктөлгөн архив туура эмес. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-KB-0001` | 501 | билим базасы иштетилген эмес | `err.kb.not_enabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-KB-0002` | 500 | сакталган конфиг бузук | `err.kb.config_corrupt` | Күтүлбөгөн ички бузулуу. | | `AIH-KB-0003` | 400 | жараксыз билим архиви | `err.kb.invalid_archive` | Бузук, толук эмес же жараксыз суроо кириши. | ## MEDIA Медиа blob алуу/агым чекиттери: кол коюлган-token медиа жетүүсү. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | медиа табылган жок | `err.media.not_found` | Шилтемеленген объект жок же көлөмдөн тышкары. | | `AIH-MEDIA-0002` | 403 | жараксыз же мөөнөтү бүткөн медиа token | `err.media.token_invalid` | Ресурс башка ижарачыга/ээсине/сессияга таандык. | ## MEMORY Узак мөөнөттүү эстутум (Einstein) админ бети: эстутум backend'и туташтырылган эмес. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | эстутум конфигурацияланган эмес | `err.memory.not_configured` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | ## MODULE Плагин/модуль marketplace башкаруу бети: мүмкүнчүлүк өчүк, булак/орнотуу жок, ээлик, же бузук side-load жүктөө. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | marketplace иштетилген эмес | `err.module.not_enabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-MODULE-0002` | 404 | булак табылган жок | `err.module.source_not_found` | Шилтемеленген объект жок же көлөмдөн тышкары. | | `AIH-MODULE-0003` | 404 | орнотуу табылган жок | `err.module.installation_not_found` | Шилтемеленген объект жок же көлөмдөн тышкары. | | `AIH-MODULE-0004` | 403 | сиздин орнотууңуз эмес | `err.module.installation_forbidden` | Ресурс башка ижарачыга/ээсине/сессияга таандык. | | `AIH-MODULE-0005` | 501 | плагин жүктөө өчүрүлгөн (blob store жок) | `err.module.upload_disabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-MODULE-0006` | 400 | жараксыз плагин жүктөө топтому | `err.module.invalid_bundle` | Бузук, толук эмес же жараксыз суроо кириши. | ## SECRET Ар-ижарачылык жашыруундар vault'у: мастер ачкыч жок, же аталган жашыруун жок. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | жашыруундар конфигурацияланган эмес | `err.secret.not_configured` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-SECRET-0002` | 404 | жашыруун табылган жок | `err.secret.not_found` | Шилтемеленген объект жок же көлөмдөн тышкары. | ## SESSION Маектешүү/сессия + кабар админ бети: мүмкүнчүлүк өчүк, же маектешүү/кабар чакыруучуга таандык эмес. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-SESSION-0001` | 501 | маектешүүлөр иштетилген эмес | `err.session.not_enabled` | Мүмкүнчүлүк/интеграция өчүрүлгөн же конфигурацияланган эмес. | | `AIH-SESSION-0002` | 403 | сиздин маектешүүңүз эмес | `err.session.conversation_forbidden` | Ресурс башка ижарачыга/ээсине/сессияга таандык. | | `AIH-SESSION-0003` | 403 | сиздин кабарыңыз эмес | `err.session.message_forbidden` | Ресурс башка ижарачыга/ээсине/сессияга таандык. | ## VOICE Үн кезеги чекити (/v1/voice/turn): SIP-көпүрө → gateway аудио-кезек бети. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | маектешүүнү чечүү мүмкүн болгон жок | `err.voice.resolve_failed` | Upstream/провайдер чакырыгы ишке ашкан жок. | | `AIH-VOICE-0002` | 502 | үн кезеги ишке ашкан жок | `err.voice.turn_failed` | Upstream/провайдер чакырыгы ишке ашкан жок. | ## WEBCONN Орнотулуучу web-chat виджет коннектору: браузер сессиясы + SSE chat. Агымдык SSE ката окуялары бул конверттин бөлүгү эмес. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | маектешүү сиздин сессияңызга таандык эмес | `err.webconn.forbidden` | Ресурс башка ижарачыга/ээсине/сессияга таандык. | | `AIH-WEBCONN-0002` | 500 | агым колдоого алынбайт | `err.webconn.streaming_unsupported` | Күтүлбөгөн ички бузулуу. | ## WORKSPACE Жумушчу мейкиндик ээлиги/чектөөсү: аракеттенген ижарачы өзүнө таандык эмес жумушчу мейкиндикте аракет кылды. | Code | HTTP | Мааниси | i18n key | Типтүү себеби | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | сиздин жумушчу мейкиндигиңиз эмес | `err.workspace.forbidden` | Ресурс башка ижарачыга/ээсине/сессияга таандык. |