შეცდომის კოდები

{ "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 გასაღები, რომელსაც კლიენტები იყენებენ ლოკალიზაციისთვის; `details` არის სურვილისამებრ სტრუქტურირებული კონტექსტი. კოდები ჭეშმარიტების ერთადერთი წყაროა `internal/apierr`-ში და ეს გვერდი ასახავს ამ რეესტრს. > ბილინგის / გეგმის-უფლებამოსილების შეცდომები (402 "upgrade required" ზედაპირი) **არ** არის აქ ჩამოთვლილი — ისინი დოკუმენტირებულია ბილინგის დოკუმენტაციაში. ## COMMON ჯვარედინი შეცდომები, საზიარო ყველა სერვისისთვის (მოთხოვნის ფორმა, მეთოდი, ავთენტიფიკაცია, შიდა გაუმართაობები). უპირატესია დომენ-სპეციფიკური კოდი, როცა ერთი მათგანი ერგება. | 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 | upstream შეცდომა | `err.common.upstream` | upstream/პროვაიდერის გამოძახება ჩავარდა. | ## 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 | ლოკალური ავთენტიფიკაცია არ არის ჩართული | `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 გამოსყიდვა), მოწყობილობის-სესიის ვალიდაცია, მიბმის სტატუსი. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `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 მოწმდება კატალოგის წინააღმდეგ ასინქრონული deploy-ის წინ. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | უცნობი მოდული: არ არის კატალოგში | `err.marketplace.unknown_module` | მითითებული ობიექტი არ არსებობს ან არ შედის ხედვის არეში. | ## LLM პროდუქტში ჩაშენებული "Connect Codex (ChatGPT subscription)" მოწყობილობის-ავტორიზაციის ნაკადი. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex connect მიუწვდომელია: საიდუმლოების საცავი (AIHUMMER_MASTER_KEY) არ არის კონფიგურირებული | `err.llm.codex_connect_disabled` | ფუნქცია/ინტეგრაცია გამორთულია ან არ არის კონფიგურირებული. | | `AIH-LLM-0002` | 502 | Codex მოწყობილობის-ავტორიზაციის ნაკადის დაწყება ვერ მოხერხდა | `err.llm.codex_connect_start_failed` | upstream/პროვაიდერის გამოძახება ჩავარდა. | | `AIH-LLM-0003` | 500 | შენახული Codex კავშირის გასუფთავება ვერ მოხერხდა | `err.llm.codex_disconnect_failed` | მოულოდნელი შიდა გაუმართაობა. | ## AGENT AI-თანამშრომლის (აგენტის) CRUD, ვერსიები, კლონირება და თითო-აგენტის სისტემურ-პრომპტის პროფილი. | 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 გასაღები | `err.chat.invalid_key` | დამახინჯებული, არასრული ან არასწორი მოთხოვნის შემავალი მონაცემები. | | `AIH-CHAT-0003` | 400 | არასწორი chat მოთხოვნა | `err.chat.invalid_request` | დამახინჯებული, არასრული ან არასწორი მოთხოვნის შემავალი მონაცემები. | | `AIH-CHAT-0004` | 429 | სიხშირის ან ბიუჯეტის ლიმიტი გადაჭარბდა | `err.chat.rate_limited` | ძალიან ბევრი მოთხოვნა / კონფიგურირებული ბიუჯეტის ზევით. | | `AIH-CHAT-0005` | 502 | chat ბიჯი ჩავარდა | `err.chat.turn_failed` | upstream/პროვაიდერის გამოძახება ჩავარდა. | | `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 | შემომავალი დისპეტჩერიზაცია ჩავარდა | `err.inbound.dispatch_failed` | მოულოდნელი შიდა გაუმართაობა. | ## KB ცოდნის-ბაზის connector-ები: RAG ფუნქცია გამორთული, შენახული connector-ის კონფიგი დაზიანებული ან ცუდი ატვირთული არქივი. | 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-ის წამოღება/სტრიმინგის წერტილები: ხელმოწერილ-ტოკენიანი მედია წვდომა. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | მედია ვერ მოიძებნა | `err.media.not_found` | მითითებული ობიექტი არ არსებობს ან არ შედის ხედვის არეში. | | `AIH-MEDIA-0002` | 403 | არასწორი ან ვადაგასული მედია ტოკენი | `err.media.token_invalid` | რესურსი ეკუთვნის სხვა მოიჯარეს/მფლობელს/სესიას. | ## MEMORY გრძელვადიანი მეხსიერების (Einstein) ადმინ ზედაპირი: მეხსიერების backend არ არის შეერთებული. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | მეხსიერება არ არის კონფიგურირებული | `err.memory.not_configured` | ფუნქცია/ინტეგრაცია გამორთულია ან არ არის კონფიგურირებული. | ## MODULE დანამატის/მოდულის მარკეტფლეისის მართვის ზედაპირი: ფუნქცია გამორთული, აკლია წყარო/ინსტალაცია, საკუთრება ან დამახინჯებული გვერდიდან-ჩატვირთვის ატვირთვა. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `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 თითო-მოიჯარის საიდუმლოების საცავი: მთავარი გასაღები არ არსებობს, ან დასახელებული საიდუმლო არ არსებობს. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | საიდუმლოები არ არის კონფიგურირებული | `err.secret.not_configured` | ფუნქცია/ინტეგრაცია გამორთულია ან არ არის კონფიგურირებული. | | `AIH-SECRET-0002` | 404 | საიდუმლო ვერ მოიძებნა | `err.secret.not_found` | მითითებული ობიექტი არ არსებობს ან არ შედის ხედვის არეში. | ## SESSION საუბრის/სესიის + შეტყობინების ადმინ ზედაპირი: ფუნქცია გამორთული, ან საუბარი/შეტყობინება არ ეკუთვნის გამომძახებელს. | 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 ხმოვანი ბიჯის წერტილი (/v1/voice/turn): SIP-ხიდი → gateway აუდიო-ბიჯის ზედაპირი. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | საუბრის გადაწყვეტა ვერ მოხერხდა | `err.voice.resolve_failed` | upstream/პროვაიდერის გამოძახება ჩავარდა. | | `AIH-VOICE-0002` | 502 | ხმოვანი ბიჯი ჩავარდა | `err.voice.turn_failed` | upstream/პროვაიდერის გამოძახება ჩავარდა. | ## WEBCONN ჩასართავი ვებ-ჩატის ვიჯეტის connector: ბრაუზერის სესია + SSE ჩატი. სტრიმინგ SSE შეცდომის მოვლენები არ შედის ამ კონვერტში. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | საუბარი არ ეკუთვნის შენს სესიას | `err.webconn.forbidden` | რესურსი ეკუთვნის სხვა მოიჯარეს/მფლობელს/სესიას. | | `AIH-WEBCONN-0002` | 500 | სტრიმინგი მხარდაუჭერელია | `err.webconn.streaming_unsupported` | მოულოდნელი შიდა გაუმართაობა. | ## WORKSPACE სამუშაო სივრცის საკუთრება/არეალი: მოქმედი მოიჯარემ იმოქმედა სამუშაო სივრცეზე, რომელიც მას არ ეკუთვნის. | Code | HTTP | მნიშვნელობა | i18n key | ტიპური მიზეზი | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | არ არის შენი სამუშაო სივრცე | `err.workspace.forbidden` | რესურსი ეკუთვნის სხვა მოიჯარეს/მფლობელს/სესიას. |