Սխալների կոդեր

{ "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 բանալին է, որ հաճախորդներն օգտագործում են localize անելու համար; `details`-ն ընտրովի կառուցվածքային համատեքստ է։ Կոդերը միակ ճշմարտության աղբյուրն են `internal/apierr`-ում, և այս էջն արտացոլում է այդ ռեգիստրը։ > Billing / plan-entitlement սխալները (402 "upgrade required" մակերեսը) այստեղ **չեն** թվարկված — դրանք փաստաթղթավորված են billing փաստաթղթերում։ ## COMMON Միջոլորտային սխալներ, որ կիսում է յուրաքանչյուր ծառայություն (հարցման ձև, մեթոդ, auth, ներքին ձախողումներ)։ Տիրույթ-հատուկ կոդը նախընտրելի է, երբ այդպիսին համապատասխանում է։ | 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 | վերընթաց սխալ | `err.common.upstream` | Վերընթաց/մատակարարի կանչը ձախողվեց։ | ## AUTH Admin տեղական-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 | տեղական auth-ը միացված չէ | `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 | երկգործոն auth-ը միացված չէ | `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 | վատ inbound secret | `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)" device-authorization հոսք։ | Code | HTTP | Նշանակություն | i18n key | Տիպիկ պատճառ | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex connect-ն անհասանելի է. secrets vault-ը (AIHUMMER_MASTER_KEY) կարգավորված չէ | `err.llm.codex_connect_disabled` | Հնարավորությունը/ինտեգրացիան անջատված է կամ չկարգավորված։ | | `AIH-LLM-0002` | 502 | չհաջողվեց սկսել Codex device-authorization հոսքը | `err.llm.codex_connect_start_failed` | Վերընթաց/մատակարարի կանչը ձախողվեց։ | | `AIH-LLM-0003` | 500 | չհաջողվեց մաքրել պահված Codex կապը | `err.llm.codex_disconnect_failed` | Անսպասելի ներքին ձախողում։ | ## AGENT AI-աշխատակից (ագենտ) CRUD, տարբերակներ, clone և ագենտ-ըստ-ագենտի system-prompt-ի պրոֆիլ։ | 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 key | `err.chat.invalid_key` | Աղավաղված, թերի կամ անվավեր հարցման մուտք։ | | `AIH-CHAT-0003` | 400 | անվավեր chat հարցում | `err.chat.invalid_request` | Աղավաղված, թերի կամ անվավեր հարցման մուտք։ | | `AIH-CHAT-0004` | 429 | գերազանցվել է rate կամ բյուջեի սահմանը | `err.chat.rate_limited` | Չափազանց շատ հարցումներ / գերազանցում սահմանված բյուջեն։ | | `AIH-CHAT-0005` | 502 | chat turn-ը ձախողվեց | `err.chat.turn_failed` | Վերընթաց/մատակարարի կանչը ձախողվեց։ | | `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 | մուտքային dispatch-ը ձախողվեց | `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 fetch/stream վերջնակետեր՝ ստորագրված-token մեդիա մուտք։ | Code | HTTP | Նշանակություն | i18n key | Տիպիկ պատճառ | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | մեդիան չի գտնվել | `err.media.not_found` | Հղվող օբյեկտը գոյություն չունի կամ շրջանակից դուրս է։ | | `AIH-MEDIA-0002` | 403 | անվավեր կամ ժամկետանց media token | `err.media.token_invalid` | Ռեսուրսը պատկանում է այլ վարձակալի/սեփականատիրոջ/սեսիայի։ | ## MEMORY Երկարաժամկետ հիշողություն (Einstein) admin մակերես՝ հիշողության 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 Վարձակալ-ըստ-վարձակալի secret vault՝ master key-ը բացակայում է, կամ անվանված secret-ը գոյություն չունի։ | Code | HTTP | Նշանակություն | i18n key | Տիպիկ պատճառ | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | secrets-ը կարգավորված չէ | `err.secret.not_configured` | Հնարավորությունը/ինտեգրացիան անջատված է կամ չկարգավորված։ | | `AIH-SECRET-0002` | 404 | secret-ը չի գտնվել | `err.secret.not_found` | Հղվող օբյեկտը գոյություն չունի կամ շրջանակից դուրս է։ | ## SESSION Զրույց/սեսիա + հաղորդագրության admin մակերես՝ հնարավորությունն անջատված, կամ զրույցը/հաղորդագրությունը կանչողինը չէ։ | 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 Voice turn վերջնակետ (/v1/voice/turn)՝ SIP-կամուրջ → gateway աուդիո-turn մակերես։ | Code | HTTP | Նշանակություն | i18n key | Տիպիկ պատճառ | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | չհաջողվեց որոշել զրույցը | `err.voice.resolve_failed` | Վերընթաց/մատակարարի կանչը ձախողվեց։ | | `AIH-VOICE-0002` | 502 | voice turn-ը ձախողվեց | `err.voice.turn_failed` | Վերընթաց/մատակարարի կանչը ձախողվեց։ | ## WEBCONN Ներդրվող web-chat widget կոնեկտոր՝ բրաուզերի սեսիա + SSE չաթ։ Հոսքային SSE սխալի իրադարձությունները այս envelope-ի մաս չեն կազմում։ | Code | HTTP | Նշանակություն | i18n key | Տիպիկ պատճառ | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | զրույցը չի պատկանում ձեր սեսիային | `err.webconn.forbidden` | Ռեսուրսը պատկանում է այլ վարձակալի/սեփականատիրոջ/սեսիայի։ | | `AIH-WEBCONN-0002` | 500 | հոսքն աջակցված չէ | `err.webconn.streaming_unsupported` | Անսպասելի ներքին ձախողում։ | ## WORKSPACE Workspace-ի սեփականություն/շրջանակ՝ գործող վարձակալը գործել է workspace-ի վրա, որը չի պատկանում իրեն։ | Code | HTTP | Նշանակություն | i18n key | Տիպիկ պատճառ | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | ձեր workspace-ը չէ | `err.workspace.forbidden` | Ռեսուրսը պատկանում է այլ վարձակալի/սեփականատիրոջ/սեսիայի։ |