Коды памылак
Кожная памылка API AiHummer нясе стабільны машынны код у форме AIH-<DOMAIN>-<NNNN>. Структура на провадзе наступная:
{ "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
Унутрыпрадуктавы паток аўтарызацыі прылады “Connect 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
CRUD AI-супрацоўніка (агента), версіі, кланаванне і профіль сістэмнага промпта для кожнага агента.
| Код | 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 эндпойнт chat-completions. Структура на провадзе застаецца сумяшчальнай з 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/ingest: прыём паведамленняў канал→шлюз.
| Код | 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
Эндпойнты атрымання/струменевання медыя-блобаў: доступ да медыя па падпісаным токене.
| Код | 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
Кіруючая паверхня маркетплейса плагінаў/модуляў: функцыя адключана, адсутнічае крыніца/усталяванне, праблема ўладання або скажоны загружаны side-load.
| Код | 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 | загрузка плагіна адключана (няма сховішча блобаў) | 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 |
Рэсурс належыць іншаму арандатару/уладальніку/сесіі. |