Агха акодқәа — AiHummer Адокументациа

AiHummer API агха зегьы ицуп иҕәҕәоу амашьынатә код абас аформа аҟны 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

Аплагин амаркетплейс аиҿкаара амҩа: аслаг акаталог инақәыршәаны иагәаҭоит асинхронтә деплои аԥхьа.

Код	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	ахкы документ ма код акәзароуп	`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

Зегьырзу аиҭаҩратә вебхук/аиагара эндпоинтқәа: канал→гейтуеи ацҳамҭа аиагара.

Код	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

Аплагин/амодуль амаркетплейс анапхгара аган: афункциа иаанкылоуп, аҵаакыра/аиҿкаара анымҟа, аԥшәмара, ма иаабац хазы-иаагалоу аҭгалара.

Код	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`	Аресурс даҽа тенант/аԥшәма/асессиа иатәуп.