Xəta kodları

{ "error": { "code": "AIH-AUTH-0001",
             "message": "invalid login or password",
             "message_key": "err.auth.invalid_credentials",
             "details": { } } }

Hər AiHummer API xətası `AIH-<DOMAIN>-<NNNN>` formasında **sabit maşın kodu** daşıyır. Şəbəkə forması belədir: ```json { "error": { "code": "AIH-AUTH-0001", "message": "invalid login or password", "message_key": "err.auth.invalid_credentials", "details": { } } } ``` `code` sabitdir (heç vaxt təkrar istifadə olunmur və nömrələnmir); `message` insan üçün ingiliscə sətirdir; `message_key` müştərilərin lokallaşdırma üçün istifadə etdiyi i18n açarıdır; `details` istəyə bağlı strukturlaşdırılmış kontekstdir. Kodlar `internal/apierr`-də yeganə həqiqət mənbəyidir və bu səhifə həmin reyestri əks etdirir. > Billinq / plan-hüquq xətaları (402 "yeniləmə tələb olunur" səthi) burada **sadalanmır** — onlar billinq sənədlərində təsvir edilib. ## COMMON Hər xidmət tərəfindən paylaşılan kəsişən xətalar (sorğu forması, metod, autentifikasiya, daxili nasazlıqlar). Uyğun gələn domenə-xas kod üstünlük təşkil edir. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-COMMON-0001` | 405 | metoda icazə yoxdur | `err.common.method_not_allowed` | HTTP metoduna bu marşrut üçün icazə verilmir. | | `AIH-COMMON-0002` | 400 | yararsız sorğu gövdəsi | `err.common.invalid_body` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-COMMON-0003` | 400 | tələb olunan sahə çatışmır | `err.common.missing_field` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-COMMON-0004` | 500 | daxili xəta | `err.common.internal` | Gözlənilməz daxili nasazlıq. | | `AIH-COMMON-0005` | 404 | tapılmadı | `err.common.not_found` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | | `AIH-COMMON-0006` | 403 | qadağandır | `err.common.forbidden` | Gözlənilməz daxili nasazlıq. | | `AIH-COMMON-0007` | 501 | funksiya aktivləşdirilməyib | `err.common.not_enabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-COMMON-0008` | 401 | icazəsiz | `err.common.unauthorized` | Çatışmayan və ya yararsız etimadnamələr. | | `AIH-COMMON-0009` | 400 | doğrulama uğursuz oldu | `err.common.validation` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-COMMON-0010` | 409 | ziddiyyət | `err.common.conflict` | Cari vəziyyətlə ziddiyyət təşkil edir. | | `AIH-COMMON-0011` | 429 | sürət limiti aşıldı | `err.common.rate_limited` | Həddən çox sorğu / konfiqurasiya olunmuş büdcədən artıq. | | `AIH-COMMON-0012` | 502 | upstream xətası | `err.common.upstream` | Upstream/provayder çağırışı uğursuz oldu. | ## AUTH Admin yerli-autentifikasiya: giriş, sessiyalar, parol dəyişikliyi, istifadəçi idarəetməsi, 2FA. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-AUTH-0001` | 401 | yararsız giriş və ya parol | `err.auth.invalid_credentials` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-AUTH-0002` | 429 | çox cəhd edildi, sonra yenidən cəhd edin | `err.auth.too_many_attempts` | Həddən çox sorğu / konfiqurasiya olunmuş büdcədən artıq. | | `AIH-AUTH-0003` | 401 | autentifikasiya edilməyib | `err.auth.not_authenticated` | Çatışmayan və ya yararsız etimadnamələr. | | `AIH-AUTH-0004` | 501 | yerli autentifikasiya aktivləşdirilməyib | `err.auth.local_disabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-AUTH-0005` | 403 | cari parol səhvdir | `err.auth.wrong_current_password` | Resurs başqa kirayəçiyə/sahibə/sessiyaya aiddir. | | `AIH-AUTH-0006` | 409 | öz hesabınızı silə bilməzsiniz | `err.auth.cannot_delete_self` | Cari vəziyyətlə ziddiyyət təşkil edir. | | `AIH-AUTH-0007` | 500 | sessiya yaradıla bilmədi | `err.auth.session_failed` | Gözlənilməz daxili nasazlıq. | | `AIH-AUTH-0008` | 501 | iki-faktorlu autentifikasiya aktivləşdirilməyib | `err.auth.twofa_disabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-AUTH-0009` | 401 | çağırışın vaxtı bitdi — yenidən daxil olun | `err.auth.twofa_challenge_expired` | Çatışmayan və ya yararsız etimadnamələr. | | `AIH-AUTH-0010` | 401 | yararsız kod | `err.auth.twofa_invalid_code` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-AUTH-0011` | 401 | yararsız bərpa kodu | `err.auth.twofa_invalid_recovery` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-AUTH-0012` | 401 | ikinci-faktor doğrulaması uğursuz oldu | `err.auth.twofa_verify_failed` | Çatışmayan və ya yararsız etimadnamələr. | | `AIH-AUTH-0013` | 400 | uyğun gələn ikinci faktor qeydiyyatdan keçməyib | `err.auth.twofa_not_enrolled` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | ## PAIRING Cihaz qoşalaşdırması (QR redeem), cihaz-sessiya doğrulaması, bağlama statusu. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-PAIRING-0001` | 400 | qoşalaşdırma kodu tələb olunur | `err.pairing.code_required` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-PAIRING-0002` | 401 | yararsız və ya vaxtı keçmiş qoşalaşdırma kodu | `err.pairing.invalid_code` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-PAIRING-0003` | 401 | yararsız daxilolan sirr | `err.pairing.bad_inbound_secret` | Çatışmayan və ya yararsız etimadnamələr. | | `AIH-PAIRING-0004` | 400 | tələb olunan sahə çatışmır | `err.pairing.field_required` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-PAIRING-0005` | 401 | yararsız və ya vaxtı keçmiş sessiya | `err.pairing.session_invalid` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-PAIRING-0006` | 400 | token tələb olunur | `err.pairing.token_required` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | ## MARKETPLACE Plagin marketpleys quraşdırma yolu: slug async deploydan əvvəl kataloqa qarşı doğrulanır. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | naməlum modul: kataloqda yoxdur | `err.marketplace.unknown_module` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | ## LLM Məhsuldaxili "Codex-ə qoşul (ChatGPT abunəliyi)" cihaz-avtorizasiya axını. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex connect əlçatan deyil: sirlər vaultu (AIHUMMER_MASTER_KEY) konfiqurasiya edilməyib | `err.llm.codex_connect_disabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-LLM-0002` | 502 | Codex cihaz-avtorizasiya axını başladıla bilmədi | `err.llm.codex_connect_start_failed` | Upstream/provayder çağırışı uğursuz oldu. | | `AIH-LLM-0003` | 500 | saxlanılan Codex bağlantısı təmizlənə bilmədi | `err.llm.codex_disconnect_failed` | Gözlənilməz daxili nasazlıq. | ## AGENT AI-əməkdaş (agent) CRUD, versiyalar, klon və per-agent sistem-prompt profili. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-AGENT-0001` | 501 | agentlər aktivləşdirilməyib | `err.agent.not_enabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-AGENT-0002` | 404 | agent tapılmadı | `err.agent.not_found` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | | `AIH-AGENT-0003` | 403 | sizin agentiniz deyil | `err.agent.forbidden` | Resurs başqa kirayəçiyə/sahibə/sessiyaya aiddir. | | `AIH-AGENT-0004` | 501 | agent profilləri aktivləşdirilməyib | `err.agent.profile_not_enabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-AGENT-0005` | 404 | paylaşılan bölmə tapılmadı | `err.agent.section_not_found` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | | `AIH-AGENT-0006` | 403 | sizin paylaşılan bölməniz deyil | `err.agent.section_forbidden` | Resurs başqa kirayəçiyə/sahibə/sessiyaya aiddir. | | `AIH-AGENT-0007` | 400 | naməlum bölmə növü | `err.agent.unknown_section_kind` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | ## APPROVAL İnsan-dövrədə təsdiq növbəsi: təsdiq funksiyası söndürülüb. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | təsdiqlər aktivləşdirilməyib | `err.approval.not_enabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | ## ARTIFACT Söhbət artefaktları (sənədlər + icra edilə bilən kod): code-exec söndürülüb, çatışmayan artefakt/versiya, yanlış növ və ya yararsız runner çıxışı. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-ARTIFACT-0001` | 501 | kod icrası aktivləşdirilməyib | `err.artifact.exec_disabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-ARTIFACT-0002` | 404 | artefakt tapılmadı | `err.artifact.not_found` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | | `AIH-ARTIFACT-0003` | 404 | artefakt versiyası tapılmadı | `err.artifact.version_not_found` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | | `AIH-ARTIFACT-0004` | 400 | artefakt kod deyil | `err.artifact.not_code` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-ARTIFACT-0005` | 500 | yararsız runner çıxışı | `err.artifact.bad_runner_output` | Gözlənilməz daxili nasazlıq. | | `AIH-ARTIFACT-0006` | 400 | növ sənəd və ya kod olmalıdır | `err.artifact.invalid_kind` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | ## CHAT OpenAI-uyğun chat-completions son nöqtəsi. Şəbəkə forması sabit kod əlavə edərkən OpenAI-uyğun qalır. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | openai-uyğun son nöqtə söndürülüb | `err.chat.disabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-CHAT-0002` | 401 | yararsız api açarı | `err.chat.invalid_key` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-CHAT-0003` | 400 | yararsız chat sorğusu | `err.chat.invalid_request` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-CHAT-0004` | 429 | sürət və ya büdcə limiti aşıldı | `err.chat.rate_limited` | Həddən çox sorğu / konfiqurasiya olunmuş büdcədən artıq. | | `AIH-CHAT-0005` | 502 | chat növbəsi uğursuz oldu | `err.chat.turn_failed` | Upstream/provayder çağırışı uğursuz oldu. | | `AIH-CHAT-0006` | 500 | chat tamamlanması uğursuz oldu | `err.chat.internal` | Gözlənilməz daxili nasazlıq. | ## INBOUND Ümumi daxilolan webhook/ingest son nöqtələri: kanal→şlüz mesaj qəbulu. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | icazəsiz | `err.inbound.unauthorized` | Çatışmayan və ya yararsız etimadnamələr. | | `AIH-INBOUND-0002` | 400 | yararsız daxilolan yük | `err.inbound.invalid_payload` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | | `AIH-INBOUND-0003` | 500 | daxilolan dispetçer uğursuz oldu | `err.inbound.dispatch_failed` | Gözlənilməz daxili nasazlıq. | ## KB Bilik-bazası konnektorları: RAG funksiyası söndürülüb, saxlanılan konnektor konfiqurasiyası zədəli və ya yararsız yüklənmiş arxiv. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-KB-0001` | 501 | bilik bazası aktivləşdirilməyib | `err.kb.not_enabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-KB-0002` | 500 | saxlanılan konfiqurasiya zədəlidir | `err.kb.config_corrupt` | Gözlənilməz daxili nasazlıq. | | `AIH-KB-0003` | 400 | yararsız bilik arxivi | `err.kb.invalid_archive` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | ## MEDIA Media blob fetch/stream son nöqtələri: imzalanmış-token media girişi. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | media tapılmadı | `err.media.not_found` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | | `AIH-MEDIA-0002` | 403 | yararsız və ya vaxtı keçmiş media tokeni | `err.media.token_invalid` | Resurs başqa kirayəçiyə/sahibə/sessiyaya aiddir. | ## MEMORY Uzunmüddətli yaddaş (Einstein) admin səthi: yaddaş arxa hissəsi qoşulmayıb. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | yaddaş konfiqurasiya edilməyib | `err.memory.not_configured` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | ## MODULE Plagin/modul marketpleys idarəetmə səthi: funksiya söndürülüb, çatışmayan mənbə/quraşdırma, sahiblik və ya səhv formatlanmış side-load yükləməsi. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | marketpleys aktivləşdirilməyib | `err.module.not_enabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-MODULE-0002` | 404 | mənbə tapılmadı | `err.module.source_not_found` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | | `AIH-MODULE-0003` | 404 | quraşdırma tapılmadı | `err.module.installation_not_found` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | | `AIH-MODULE-0004` | 403 | sizin quraşdırmanız deyil | `err.module.installation_forbidden` | Resurs başqa kirayəçiyə/sahibə/sessiyaya aiddir. | | `AIH-MODULE-0005` | 501 | plagin yükləməsi söndürülüb (blob anbarı yoxdur) | `err.module.upload_disabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-MODULE-0006` | 400 | yararsız plagin yükləmə paketi | `err.module.invalid_bundle` | Səhv formatlanmış, natamam və ya yararsız sorğu girişi. | ## SECRET Per-tenant sirr vaultu: master açar yoxdur və ya adlandırılmış sirr mövcud deyil. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | sirlər konfiqurasiya edilməyib | `err.secret.not_configured` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-SECRET-0002` | 404 | sirr tapılmadı | `err.secret.not_found` | İstinad edilən obyekt mövcud deyil və ya əhatə dairəsindən kənardadır. | ## SESSION Söhbət/sessiya + mesaj admin səthi: funksiya söndürülüb və ya söhbət/mesaj çağıranın deyil. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-SESSION-0001` | 501 | söhbətlər aktivləşdirilməyib | `err.session.not_enabled` | Funksiya/inteqrasiya söndürülüb və ya konfiqurasiya edilməyib. | | `AIH-SESSION-0002` | 403 | sizin söhbətiniz deyil | `err.session.conversation_forbidden` | Resurs başqa kirayəçiyə/sahibə/sessiyaya aiddir. | | `AIH-SESSION-0003` | 403 | sizin mesajınız deyil | `err.session.message_forbidden` | Resurs başqa kirayəçiyə/sahibə/sessiyaya aiddir. | ## VOICE Səs növbəsi son nöqtəsi (/v1/voice/turn): SIP-körpü → şlüz audio-növbə səthi. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | söhbət həll edilə bilmədi | `err.voice.resolve_failed` | Upstream/provayder çağırışı uğursuz oldu. | | `AIH-VOICE-0002` | 502 | səs növbəsi uğursuz oldu | `err.voice.turn_failed` | Upstream/provayder çağırışı uğursuz oldu. | ## WEBCONN Quraşdırıla bilən veb-chat vidjet konnektoru: brauzer sessiyası + SSE chat. Axın SSE xəta hadisələri bu zərfin bir hissəsi deyil. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | söhbət sizin sessiyanıza aid deyil | `err.webconn.forbidden` | Resurs başqa kirayəçiyə/sahibə/sessiyaya aiddir. | | `AIH-WEBCONN-0002` | 500 | axın dəstəklənmir | `err.webconn.streaming_unsupported` | Gözlənilməz daxili nasazlıq. | ## WORKSPACE İş sahəsi sahibliyi/əhatəsi: fəaliyyət göstərən kirayəçi sahib olmadığı iş sahəsində fəaliyyət göstərdi. | Kod | HTTP | Mənası | i18n açarı | Tipik səbəb | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | sizin iş sahəniz deyil | `err.workspace.forbidden` | Resurs başqa kirayəçiyə/sahibə/sessiyaya aiddir. |