Коды ошибок
Каждая ошибка API AiHummer несёт стабильный машинный код вида AIH-<ДОМЕН>-<NNNN>. Формат ответа:
{ "error": { "code": "AIH-AUTH-0001",
"message": "invalid login or password",
"message_key": "err.auth.invalid_credentials",
"details": { } } }code стабилен (не переиспользуется и не перенумеровывается); message — человекочитаемая строка (EN); 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 |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-AUTH-0014 |
400 | Неверный или просроченный токен сброса пароля | err.auth.reset_token_invalid |
Некорректный, неполный или недопустимый ввод запроса. |
AGENT
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 |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-AGENT-0008 |
403 | Инструмент не разрешён для этого агента | err.agent.tool_not_permitted |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
AIH-AGENT-0009 |
403 | Достигнут предел вложенности субагентов | err.agent.subagent_depth_exceeded |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
AIH-AGENT-0010 |
403 | Передача (handoff) здесь недоступна | err.agent.handoff_unavailable |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
AIH-AGENT-0011 |
500 | Сбой вызова инструмента | err.agent.tool_failed |
Непредвиденный внутренний сбой. |
AIH-AGENT-0012 |
400 | Для передачи нужны поля ‘agent’ и ‘task’ | err.agent.handoff_invalid_args |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-AGENT-0013 |
404 | Агент с таким именем не найден | err.agent.handoff_target_not_found |
Указанный объект не существует или вне области видимости. |
AIH-AGENT-0014 |
400 | Не переданы задачи | err.agent.subagent_no_tasks |
Некорректный, неполный или недопустимый ввод запроса. |
APIKEY
API-ключи для программного доступа к шлюзу: подсистема ключей не настроена.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-APIKEY-0001 |
501 | API-ключи не настроены | err.apikey.not_configured |
Функция/интеграция выключена или не настроена. |
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 | Тип должен быть document или code | err.artifact.invalid_kind |
Некорректный, неполный или недопустимый ввод запроса. |
BACKUP
Резервное копирование базы данных из админки.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-BACKUP-0001 |
501 | Не настроен URL базы данных для резервного копирования | err.backup.not_configured |
Функция/интеграция выключена или не настроена. |
AIH-BACKUP-0002 |
500 | Сбой резервного копирования | err.backup.failed |
Непредвиденный внутренний сбой. |
BATCH
Пакетная обработка запросов (batches).
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-BATCH-0001 |
501 | Пакеты не включены | err.batch.not_enabled |
Функция/интеграция выключена или не настроена. |
AIH-BATCH-0002 |
404 | Пакет не найден | err.batch.not_found |
Указанный объект не существует или вне области видимости. |
BUDGET
Учёт использования и бюджеты расходов на модели.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-BUDGET-0001 |
501 | Учёт использования не включён | err.budget.usage_not_enabled |
Функция/интеграция выключена или не настроена. |
AIH-BUDGET-0002 |
501 | Бюджеты не включены | err.budget.not_enabled |
Функция/интеграция выключена или не настроена. |
BYOK
Bring-your-own-key: собственные ключи модельных провайдеров арендатора.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-BYOK-0001 |
501 | BYOK не настроен | err.byok.not_configured |
Функция/интеграция выключена или не настроена. |
CHANGE
Журнал изменений и их согласование (change management).
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-CHANGE-0001 |
404 | Изменение не найдено | err.change.not_found |
Указанный объект не существует или вне области видимости. |
AIH-CHANGE-0002 |
403 | Самоодобрение запрещено: требуется другой согласующий | err.change.self_approval_forbidden |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
CHAT
OpenAI-совместимый эндпоинт chat-completions. Формат ответа остаётся совместимым с 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 |
Непредвиденный внутренний сбой. |
CONNECTION
OAuth-подключения интеграций: connect-тикеты, шаги авторизации и обмен токенов.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-CONNECTION-0001 |
400 | Неверный или просроченный тикет подключения | err.connection.ticket_invalid |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-CONNECTION-0002 |
400 | Плагин не декларирует OAuth-поток | err.connection.no_oauth_flow |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-CONNECTION-0003 |
400 | OAuth-клиент для этого плагина не настроен | err.connection.oauth_client_not_configured |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-CONNECTION-0004 |
400 | В авторизации отказано | err.connection.auth_denied |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-CONNECTION-0005 |
400 | Отсутствует code или state | err.connection.missing_code_or_state |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-CONNECTION-0006 |
400 | Неверный или просроченный state | err.connection.state_invalid |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-CONNECTION-0007 |
400 | Конфигурация OAuth плагина недоступна | err.connection.oauth_config_unavailable |
Некорректный, неполный или недопустимый ввод запроса. |
AIH-CONNECTION-0008 |
502 | Сбой обмена токена | err.connection.token_exchange_failed |
Сбой вызова вышестоящего сервиса/провайдера. |
AIH-CONNECTION-0009 |
500 | Не удалось сохранить токен | err.connection.store_token_failed |
Непредвиденный внутренний сбой. |
CREDENTIAL
Персональное хранилище учётных данных пользователей (credential vault).
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-CREDENTIAL-0001 |
501 | Хранилище учётных данных не включено | err.credential.vault_not_enabled |
Функция/интеграция выключена или не настроена. |
AIH-CREDENTIAL-0002 |
400 | Сбой операции с учётными данными | err.credential.vault_error |
Некорректный, неполный или недопустимый ввод запроса. |
DEVICE
Мост устройств (device bridge) к приложению на устройстве пользователя.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-DEVICE-0001 |
503 | Сервис устройств недоступен | err.device.service_unavailable |
Зависимый сервис временно недоступен. |
EVENTS
Поток событий сервера (SSE) для админки и клиентов.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-EVENTS-0001 |
500 | Потоковая передача не поддерживается | err.events.streaming_unsupported |
Непредвиденный внутренний сбой. |
FACT
Факты долговременной памяти о пользователях.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-FACT-0001 |
404 | Факт не найден | err.fact.not_found |
Указанный объект не существует или вне области видимости. |
AIH-FACT-0002 |
403 | Это не пользовательский факт | err.fact.not_user_fact |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
GRAPH
Графы агентов: декларативная оркестрация нескольких агентов.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-GRAPH-0001 |
501 | Графы агентов не включены | err.graph.not_enabled |
Функция/интеграция выключена или не настроена. |
AIH-GRAPH-0002 |
404 | Граф не найден | err.graph.not_found |
Указанный объект не существует или вне области видимости. |
AIH-GRAPH-0003 |
403 | Это не ваш граф | err.graph.forbidden |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
AIH-GRAPH-0004 |
501 | Выполнение графов недоступно в этой поставке | err.graph.exec_unavailable |
Функция/интеграция выключена или не настроена. |
GUARDRAIL
Правила-ограничители (guardrails) контента и поведения агентов.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-GUARDRAIL-0001 |
501 | Ограничители не настроены | err.guardrail.not_configured |
Функция/интеграция выключена или не настроена. |
INBOUND
Универсальные входящие webhook/ingest эндпоинты: приём сообщений канал→шлюз.
| Код | 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 |
Непредвиденный внутренний сбой. |
IPALLOW
Списки разрешённых IP-адресов для доступа к админке.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-IPALLOW-0001 |
501 | Список разрешённых IP не настроен | err.ipallow.not_configured |
Функция/интеграция выключена или не настроена. |
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 |
Некорректный, неполный или недопустимый ввод запроса. |
LICENSE
Лицензирование инстанса: применение подписанной лицензии.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-LICENSE-0001 |
501 | Лицензирование не включено | err.license.not_enabled |
Функция/интеграция выключена или не настроена. |
AIH-LICENSE-0002 |
400 | Неверная лицензия | err.license.invalid |
Некорректный, неполный или недопустимый ввод запроса. |
LLM
Внутренний поток device-авторизации «Подключить Codex (подписка ChatGPT)».
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-LLM-0001 |
501 | Подключение Codex недоступно (не настроено хранилище секретов) | err.llm.codex_connect_disabled |
Функция/интеграция выключена или не настроена. |
AIH-LLM-0002 |
502 | Не удалось запустить device-авторизацию Codex | err.llm.codex_connect_start_failed |
Сбой вызова вышестоящего сервиса/провайдера. |
AIH-LLM-0003 |
500 | Не удалось удалить сохранённое подключение Codex | err.llm.codex_disconnect_failed |
Непредвиденный внутренний сбой. |
MARKETPLACE
Установка плагина из маркетплейса: slug проверяется по каталогу до асинхронного развёртывания.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-MARKETPLACE-0001 |
404 | Неизвестный модуль: отсутствует в каталоге | err.marketplace.unknown_module |
Указанный объект не существует или вне области видимости. |
MEDIA
Эндпоинты получения/стриминга медиа: доступ по подписанному токену.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-MEDIA-0001 |
404 | Медиа не найдено | err.media.not_found |
Указанный объект не существует или вне области видимости. |
AIH-MEDIA-0002 |
403 | Неверный или просроченный токен медиа | err.media.token_invalid |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
AIH-MEDIA-0003 |
503 | Понимание видео не настроено | err.media.video_not_configured |
Зависимый сервис временно недоступен. |
MEMORY
Админ-поверхность долговременной памяти (Einstein): бэкенд памяти не подключён.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-MEMORY-0001 |
501 | Память не настроена | err.memory.not_configured |
Функция/интеграция выключена или не настроена. |
MODELACCESS
Правила доступа к моделям (какие модели доступны каким пользователям/агентам).
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-MODELACCESS-0001 |
501 | Доступ к моделям не настроен | err.modelaccess.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 |
Некорректный, неполный или недопустимый ввод запроса. |
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 |
Некорректный, неполный или недопустимый ввод запроса. |
PLAYGROUND
Песочница (playground) для проб промптов и моделей.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-PLAYGROUND-0001 |
501 | Песочница не включена | err.playground.not_enabled |
Функция/интеграция выключена или не настроена. |
PROMPT
Библиотека промптов и шаблонов.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-PROMPT-0001 |
501 | Библиотека промптов не настроена | err.prompt.not_configured |
Функция/интеграция выключена или не настроена. |
AIH-PROMPT-0002 |
404 | Шаблон не найден | err.prompt.template_not_found |
Указанный объект не существует или вне области видимости. |
PUSH
Мобильные push-уведомления через реле флота (инстанс не хранит вендорские ключи).
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-PUSH-0001 |
503 | Реле push недоступно (нет шины флота / инстанс не зарегистрирован) | err.push.relay_unavailable |
Зависимый сервис временно недоступен. |
AIH-PUSH-0002 |
502 | Сбой доставки через push-реле | err.push.relay_failed |
Сбой вызова вышестоящего сервиса/провайдера. |
REGEN
Повторная генерация ответа (regenerate).
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-REGEN-0001 |
501 | Повторная генерация не включена | err.regen.not_enabled |
Функция/интеграция выключена или не настроена. |
SAML
Единый вход SAML SSO.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-SAML-0001 |
501 | SAML недоступен | err.saml.not_available |
Функция/интеграция выключена или не настроена. |
AIH-SAML-0002 |
400 | В assertion отсутствует subject | err.saml.assertion_invalid |
Некорректный, неполный или недопустимый ввод запроса. |
SCHEDULE
Отложенные/запланированные отправки сообщений.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-SCHEDULE-0001 |
404 | Запланированная отправка не найдена | err.schedule.not_found |
Указанный объект не существует или вне области видимости. |
SCIM
Провижининг пользователей по SCIM.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-SCIM-0001 |
501 | SCIM не включён | err.scim.not_enabled |
Функция/интеграция выключена или не настроена. |
SECRET
Хранилище секретов арендатора: отсутствует мастер-ключ или нет указанного секрета.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-SECRET-0001 |
501 | Хранилище секретов не настроено | err.secret.not_configured |
Функция/интеграция выключена или не настроена. |
AIH-SECRET-0002 |
404 | Секрет не найден | err.secret.not_found |
Указанный объект не существует или вне области видимости. |
SENTIMENT
Аналитика разговоров: тональность и качество.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-SENTIMENT-0001 |
501 | Аналитика разговоров не включена | err.sentiment.not_enabled |
Функция/интеграция выключена или не настроена. |
AIH-SENTIMENT-0002 |
404 | Ещё не проанализировано | err.sentiment.not_analyzed |
Указанный объект не существует или вне области видимости. |
AIH-SENTIMENT-0003 |
422 | Не удалось проанализировать разговор | err.sentiment.unprocessable |
Запрос корректен, но обработать содержимое не удалось. |
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 |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
SKILL
Навыки (skills) агентов: библиотека и владение.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-SKILL-0001 |
501 | Навыки не включены | err.skill.not_enabled |
Функция/интеграция выключена или не настроена. |
AIH-SKILL-0002 |
404 | Навык не найден | err.skill.not_found |
Указанный объект не существует или вне области видимости. |
AIH-SKILL-0003 |
403 | Это не ваш навык | err.skill.forbidden |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
SKILLOPT
Оптимизатор навыков: предложения по улучшению навыков.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-SKILLOPT-0001 |
501 | Оптимизатор навыков не включён | err.skillopt.not_enabled |
Функция/интеграция выключена или не настроена. |
AIH-SKILLOPT-0002 |
404 | Предложение не найдено | err.skillopt.proposal_not_found |
Указанный объект не существует или вне области видимости. |
AIH-SKILLOPT-0003 |
403 | Это не ваше предложение | err.skillopt.proposal_forbidden |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
SYSTEM
Системные операции хоста: логи и самообновление.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-SYSTEM-0001 |
501 | Логи недоступны на этом хосте | err.system.logs_unavailable |
Функция/интеграция выключена или не настроена. |
AIH-SYSTEM-0002 |
501 | Самообновление не настроено; выполните sudo aihummer update на хосте |
err.system.update_not_configured |
Функция/интеграция выключена или не настроена. |
USER
Управление пользователями и ролями рабочего пространства.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-USER-0001 |
409 | Нельзя менять собственные роли | err.user.cannot_change_own_roles |
Конфликт с текущим состоянием. |
AIH-USER-0002 |
409 | Нельзя удалить последнего владельца | err.user.cannot_remove_last_owner |
Конфликт с текущим состоянием. |
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 |
Непредвиденный внутренний сбой. |
WEBHOOK
Исходящие вебхуки о событиях инстанса.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-WEBHOOK-0001 |
501 | Вебхуки не включены | err.webhook.not_enabled |
Функция/интеграция выключена или не настроена. |
AIH-WEBHOOK-0002 |
404 | Вебхук не найден | err.webhook.not_found |
Указанный объект не существует или вне области видимости. |
WORKSPACE
Владение/область рабочего пространства: арендатор обратился к чужому пространству.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-WORKSPACE-0001 |
403 | Это не ваше рабочее пространство | err.workspace.forbidden |
Ресурс принадлежит другому арендатору/владельцу/сессии. |
ZAPIER
Входящий триггер Zapier-коннектора.
| Код | HTTP | Значение | Ключ i18n | Типичная причина |
|---|---|---|---|---|
AIH-ZAPIER-0001 |
501 | Входящий триггер не настроен | err.zapier.not_configured |
Функция/интеграция выключена или не настроена. |
AIH-ZAPIER-0002 |
401 | Неверная подпись или токен триггера | err.zapier.invalid_signature |
Отсутствуют или неверны учётные данные. |