Қате кодтары

{ "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 "жаңарту қажет" беті) мұнда > **тізілмеген** — олар биллинг құжаттамасында сипатталған. ## COMMON Әрбір қызмет бөлісетін көлденең қателер (сұрау пішіні, әдіс, аутентификация, ішкі сәтсіздіктер). Қолайлы болса доменге тән код артық көрінеді. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `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 | жоғары ағын қатесі | `err.common.upstream` | Жоғары ағын/провайдер шақыруы сәтсіз аяқталды. | ## AUTH Әкімші жергілікті аутентификациясы: кіру, сеанстар, құпиясөзді өзгерту, пайдаланушыларды басқару, 2FA. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `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 | сынақтың мерзімі бітті — қайта кіріңіз | `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 өтеу), құрылғы-сеансын тексеру, байлау күйі. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `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 | токен қажет | `err.pairing.token_required` | Бұрмаланған, толық емес немесе жарамсыз сұрау кірісі. | ## MARKETPLACE Плагин маркетплейсін орнату жолы: slug каталогқа қарсы асинхронды деплойдан бұрын тексеріледі. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | белгісіз модуль: каталогта жоқ | `err.marketplace.unknown_module` | Сілтенген нысан жоқ немесе аумақтан тыс. | ## LLM Өнім ішіндегі "Codex-ті қосу (ChatGPT жазылымы)" құрылғы-авторизация ағыны. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex қосылымы қолжетімсіз: құпиялар қоймасы (AIHUMMER_MASTER_KEY) бапталмаған | `err.llm.codex_connect_disabled` | Мүмкіндік/интеграция өшірулі немесе бапталмаған. | | `AIH-LLM-0002` | 502 | Codex құрылғы-авторизация ағынын бастау мүмкін болмады | `err.llm.codex_connect_start_failed` | Жоғары ағын/провайдер шақыруы сәтсіз аяқталды. | | `AIH-LLM-0003` | 500 | сақталған Codex қосылымын тазалау мүмкін болмады | `err.llm.codex_disconnect_failed` | Күтпеген ішкі сәтсіздік. | ## AGENT AI-қызметкер (агент) CRUD, нұсқалары, клон және әрбір агентке арналған жүйелік жол профилі. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `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 Адамның қатысуымен мақұлдау кезегі: мақұлдау мүмкіндігі өшірулі. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | мақұлдаулар қосылмаған | `err.approval.not_enabled` | Мүмкіндік/интеграция өшірулі немесе бапталмаған. | ## ARTIFACT Әңгіме артефактілері (құжаттар + орындалатын код): код-орындау өшірулі, артефакт/нұсқа жоқ, түрі қате немесе орындаушы шығысы қате. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `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 | орындаушы шығысы қате | `err.artifact.bad_runner_output` | Күтпеген ішкі сәтсіздік. | | `AIH-ARTIFACT-0006` | 400 | түрі document немесе code болуы керек | `err.artifact.invalid_kind` | Бұрмаланған, толық емес немесе жарамсыз сұрау кірісі. | ## CHAT OpenAI-үйлесімді чат-аяқтау соңғы нүктесі. Тарату пішіні OpenAI-үйлесімді болып қалады, тұрақты код қосылады. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | openai-үйлесімді соңғы нүкте өшірулі | `err.chat.disabled` | Мүмкіндік/интеграция өшірулі немесе бапталмаған. | | `AIH-CHAT-0002` | 401 | api кілті жарамсыз | `err.chat.invalid_key` | Бұрмаланған, толық емес немесе жарамсыз сұрау кірісі. | | `AIH-CHAT-0003` | 400 | чат сұрауы жарамсыз | `err.chat.invalid_request` | Бұрмаланған, толық емес немесе жарамсыз сұрау кірісі. | | `AIH-CHAT-0004` | 429 | жылдамдық немесе бюджет шегінен асты | `err.chat.rate_limited` | Тым көп сұрау / бапталған бюджеттен асу. | | `AIH-CHAT-0005` | 502 | чат кезегі сәтсіз аяқталды | `err.chat.turn_failed` | Жоғары ағын/провайдер шақыруы сәтсіз аяқталды. | | `AIH-CHAT-0006` | 500 | чат аяқталуы сәтсіз аяқталды | `err.chat.internal` | Күтпеген ішкі сәтсіздік. | ## INBOUND Жалпы кіріс webhook/ингест соңғы нүктелері: арна→шлюз хабарламаларды ингесттеу. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | авторизацияланбаған | `err.inbound.unauthorized` | Тіркелгі деректері жоқ немесе жарамсыз. | | `AIH-INBOUND-0002` | 400 | кіріс жүктемесі жарамсыз | `err.inbound.invalid_payload` | Бұрмаланған, толық емес немесе жарамсыз сұрау кірісі. | | `AIH-INBOUND-0003` | 500 | кіріс диспетчерлеу сәтсіз аяқталды | `err.inbound.dispatch_failed` | Күтпеген ішкі сәтсіздік. | ## KB Білім қоры коннекторлары: RAG мүмкіндігі өшірулі, сақталған коннектор конфигі бұзылған немесе жүктелген архив қате. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `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 алу/ағын соңғы нүктелері: қол қойылған токенмен медиаға қол жеткізу. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | медиа табылмады | `err.media.not_found` | Сілтенген нысан жоқ немесе аумақтан тыс. | | `AIH-MEDIA-0002` | 403 | медиа токені жарамсыз немесе мерзімі бітті | `err.media.token_invalid` | Ресурс басқа жалгерге/иеге/сеансқа тиесілі. | ## MEMORY Ұзақ мерзімді жад (Einstein) әкімші беті: жад бэкенді жалғанбаған. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | жад бапталмаған | `err.memory.not_configured` | Мүмкіндік/интеграция өшірулі немесе бапталмаған. | ## MODULE Плагин/модуль маркетплейсін басқару беті: мүмкіндік өшірулі, көз/орнату жоқ, иелік немесе бұрмаланған бүйірден жүктеу. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | маркетплейс қосылмаған | `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 қойма жоқ) | `err.module.upload_disabled` | Мүмкіндік/интеграция өшірулі немесе бапталмаған. | | `AIH-MODULE-0006` | 400 | плагин жүктеу бумасы жарамсыз | `err.module.invalid_bundle` | Бұрмаланған, толық емес немесе жарамсыз сұрау кірісі. | ## SECRET Әрбір жалгерге арналған құпия қойма: мастер кілт жоқ немесе аталған құпия жоқ. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | құпиялар бапталмаған | `err.secret.not_configured` | Мүмкіндік/интеграция өшірулі немесе бапталмаған. | | `AIH-SECRET-0002` | 404 | құпия табылмады | `err.secret.not_found` | Сілтенген нысан жоқ немесе аумақтан тыс. | ## SESSION Әңгіме/сеанс + хабарлама әкімші беті: мүмкіндік өшірулі немесе әңгіме/хабарлама шақырушыға тиесілі емес. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `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-көпір → шлюз аудио-кезегі беті. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | әңгімені шешу мүмкін болмады | `err.voice.resolve_failed` | Жоғары ағын/провайдер шақыруы сәтсіз аяқталды. | | `AIH-VOICE-0002` | 502 | дауыс кезегі сәтсіз аяқталды | `err.voice.turn_failed` | Жоғары ағын/провайдер шақыруы сәтсіз аяқталды. | ## WEBCONN Ендірілетін веб-чат виджет коннекторы: браузер сеансы + SSE чат. Ағынды SSE қате оқиғалары осы конвертке кірмейді. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | әңгіме сіздің сеансыңызға тиесілі емес | `err.webconn.forbidden` | Ресурс басқа жалгерге/иеге/сеансқа тиесілі. | | `AIH-WEBCONN-0002` | 500 | ағынға қолдау жоқ | `err.webconn.streaming_unsupported` | Күтпеген ішкі сәтсіздік. | ## WORKSPACE Жұмыс кеңістігінің иелігі/аумағы: әрекет етуші жалгер өзіне тиесілі емес жұмыс кеңістігіне әрекет етті. | Код | HTTP | Мағынасы | i18n кілті | Әдеттегі себебі | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | сіздің жұмыс кеңістігіңіз емес | `err.workspace.forbidden` | Ресурс басқа жалгерге/иеге/сеансқа тиесілі. |