AiHummer
Тоҷикӣ▾
Даромадан
v1.0.x▾
v1.0.xstable
{ }Swagger
Маълумотнома/Рамзҳои хато

Рамзҳои хато

v1.0.x · навсозӣ шуд 2026-06-29

Ҳар хатои 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 subscription)” дар дохили маҳсулот.

Рамз 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

Артефактҳои сӯҳбат (ҳуҷҷатҳо + коди иҷрошаванда): code-exec хомӯш, артефакт/версияи набуда, навъи нодуруст ё хуруҷи бади иҷрокунанда.

Рамз 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 навъ бояд ҳуҷҷат ё код бошад err.artifact.invalid_kind Вуруди дархости бадшакл, нопурра ё беэътибор.

CHAT

Нуқтаи интиҳоии chat-completions-и мувофиқи 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

Рӯи идоракунии бозори плагин/модул: хусусият хомӯш, манбаъ/насби набуда, моликият ё боргузории бадшакли 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 боргузории плагин ғайрифаъол аст (анбори 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 Манбаъ ба иҷоранишин/соҳиб/сессияи дигар тааллуқ дорад.