AiHummer
Русский▾
ВойтиЛичный кабинет
v1.6.x▾
{ }Swagger

Коды ошибок

v1.6.x · обновлено 2026-11-15

Каждая ошибка 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 — необязательный структурированный контекст.

Ошибки биллинга / лимитов тарифа (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 Некорректный, неполный или недопустимый ввод запроса.
AIH-AUTH-0015 403 Сначала задайте свой пароль err.auth.password_change_required —
AIH-AUTH-0016 400 Новый пароль должен отличаться от текущего err.auth.password_unchanged —

AGENT

CRUD ИИ-сотрудников (агентов), версии, клонирование и профиль системного промпта агента. Ошибки not_enabled (функция выключена — включите её в настройках) и forbidden (объект принадлежит другому владельцу — проверьте арендатора и права) — это разные причины с разными действиями.

Код 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 Некорректный, неполный или недопустимый ввод запроса.
AIH-AGENT-0015 403 Инструмент недоступен на управляемом инстансе AiHummer Cloud err.agent.tool_cloud_restricted —
AIH-AGENT-0016 409 Сотрудника изменили в другом месте после того, как вы открыли карточку. Откройте карточку заново и сохраните ещё раз. err.agent.revision_conflict —
AIH-AGENT-0017 400 Эту модель не обслуживает ни один включённый поставщик. Выберите модель из списка или включите её поставщика на странице «Модели». err.agent.model_not_served —
AIH-AGENT-0018 400 Правила доступа называют человека или агента, которых нет в этом рабочем пространстве. err.agent.interaction_unknown_grant —
AIH-AGENT-0019 400 Запреты субагентам называют инструмент, которого на этом экземпляре нет. err.agent.interaction_unknown_tool —
AIH-AGENT-0020 400 Выбранный поставщик выключен, удалён или не обслуживает эту модель. Выберите другой или «Любой поставщик». err.agent.model_provider_invalid —
AIH-AGENT-0021 400 У агента может быть не больше 8 своих запасных моделей. Уберите одну, прежде чем добавить другую. err.agent.too_many_spares —

APIKEY

API-ключи для программного доступа к шлюзу: подсистема ключей не настроена.

Код HTTP Значение Ключ i18n Типичная причина
AIH-APIKEY-0001 501 API-ключи не настроены err.apikey.not_configured Функция/интеграция выключена или не настроена.

APPROVAL

Очередь согласований с участием человека: функция согласований выключена.

Код HTTP Значение Ключ i18n Типичная причина
AIH-APPROVAL-0001 501 Согласования не включены err.approval.not_enabled Функция/интеграция выключена или не настроена.
AIH-APPROVAL-0002 409 Срок заявки истёк: решения не было вовремя, и вызов уже получил отказ. Если это всё ещё нужно, агент попросит снова. err.approval.expired —

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-совместимый endpoint chat-completions. Формат ответа остаётся совместимым с OpenAI, но добавляется стабильный код.

Код HTTP Значение Ключ i18n Типичная причина
AIH-CHAT-0001 501 OpenAI-совместимый endpoint отключён 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 Непредвиденный внутренний сбой.
AIH-CHAT-0007 503 LLM-провайдер не настроен — добавьте его в разделе «Модели» err.chat.no_llm_provider —

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 Ресурс принадлежит другому арендатору/владельцу/сессии.
AIH-FACT-0003 409 Статус факта не позволяет это решение: одобрить можно только кандидата, отклонить — кандидата или одобренный факт. Обновите список. err.fact.status_conflict —

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 endpoints: приём сообщений канал→шлюз.

Код 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 Непредвиденный внутренний сбой.
AIH-INBOUND-0004 503 Сервер занят — сообщение сохранено, но ещё не обработано. Повторите с тем же идентификатором сообщения. err.inbound.server_busy —

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 Некорректный, неполный или недопустимый ввод запроса.
AIH-KB-0004 413 Вложение превышает максимально допустимый размер err.session.attachment_too_large —
AIH-KB-0005 413 Вложение превышает максимально допустимый размер err.session.attachment_too_large —

LICENSE

Лицензирование инстанса: применение подписанной лицензии.

Код HTTP Значение Ключ i18n Типичная причина
AIH-LICENSE-0001 501 Лицензирование не включено err.license.not_enabled Функция/интеграция выключена или не настроена.
AIH-LICENSE-0002 400 Неверная лицензия err.license.invalid Некорректный, неполный или недопустимый ввод запроса.
AIH-LICENSE-0003 409 Для этой лицензии требуется подписанное разрешение для установки. Запросите у поставщика актуальный комплект лицензии. err.license.grant_required —

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 Непредвиденный внутренний сбой.
AIH-LLM-0004 501 Провайдеры моделей не настроены err.llm.providers_not_configured —
AIH-LLM-0005 404 Провайдер модели не найден err.llm.provider_not_found —
AIH-LLM-0006 400 Некорректная настройка провайдера модели err.llm.provider_invalid —
AIH-LLM-0007 502 Проверка провайдера не удалась err.llm.provider_test_failed —
AIH-LLM-0008 501 Проверка провайдера недоступна err.llm.provider_test_unavailable —
AIH-LLM-0009 502 OpenAI недоступен из региона сервера — требуется исходящий прокси в разрешённом регионе. Обратитесь в поддержку. err.llm.region_blocked —
AIH-LLM-0010 501 Подключение подписки Claude на этом инстансе недоступно err.llm.claude_connect_disabled —
AIH-LLM-0011 502 Не удалось подключить подписку Claude err.llm.claude_connect_failed —
AIH-LLM-0012 500 Не удалось отключить сохранённую подписку Claude err.llm.claude_disconnect_failed —
AIH-LLM-0013 400 Эта учётная запись не обслуживает такую модель: выберите модель из списка учётной записи. err.llm.provider_model_not_in_catalog —

MARKETPLACE

Установка плагина из маркетплейса: slug проверяется по каталогу до асинхронного развёртывания.

Код HTTP Значение Ключ i18n Типичная причина
AIH-MARKETPLACE-0001 404 Неизвестный модуль: отсутствует в каталоге err.marketplace.unknown_module Указанный объект не существует или вне области видимости.

MEDIA

Endpoints получения/потоковой передачи медиа: доступ по подписанному токену.

Код 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 Функция/интеграция выключена или не настроена.
AIH-MEMORY-0002 404 Противоречие не найдено — обновите список. err.memory.contradiction_not_found —
AIH-MEMORY-0003 409 Противоречие уже решено или открыто снова — обновите список. err.memory.contradiction_conflict —
AIH-MEMORY-0004 409 Проверка памяти уже идёт. Дождитесь её окончания. err.memory.quality_busy —
AIH-MEMORY-0005 404 Такого исправления больше нет — обновите страницу. err.memory.quality_fix_not_found —
AIH-MEMORY-0006 409 Это исправление нельзя отменить: оно уже отменено, или факты менялись после него. err.memory.quality_fix_conflict —

MODELACCESS

Правила доступа к моделям (какие модели доступны каким пользователям/агентам).

Код HTTP Значение Ключ i18n Типичная причина
AIH-MODELACCESS-0001 501 Доступ к моделям не настроен err.modelaccess.not_configured Функция/интеграция выключена или не настроена.

MODULE

Управление маркетплейсом плагинов. Разные причины требуют разных действий: not_enabled — маркетплейс выключен (включите в настройках); *_not_found — нет такого источника/установки (проверьте идентификатор); forbidden — чужая установка (проверьте рабочее пространство); invalid_bundle — некорректная загрузка (пересоберите пакет через aihummer plugin package).

Код 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 Некорректный, неполный или недопустимый ввод запроса.
AIH-MODULE-0007 403 Официальный источник каталога нельзя отключить или удалить err.module.source_protected —
AIH-MODULE-0008 403 Этот модуль — встроенная часть продукта, его нельзя удалить или остановить err.module.builtin_protected —
AIH-MODULE-0009 409 Этот плагин запрашивает разрешения — просмотрите и подтвердите их перед установкой err.module.consent_required —
AIH-MODULE-0010 400 Плагин запрашивает доступ, не заявленный в его манифесте возможностей err.module.capability_violation —
AIH-MODULE-0011 410 Этот модуль снят с продукта: его функция встроена в ядро, поставить его больше нельзя err.module.retired —

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 Некорректный, неполный или недопустимый ввод запроса.
AIH-PAIRING-0007 401 Срок действия кода сопряжения истёк — создайте новый QR-код и отсканируйте его заново. err.pairing.code_expired —
AIH-PAIRING-0008 401 Этот код сопряжения уже был использован — создайте новый QR-код. err.pairing.code_used —
AIH-PAIRING-0009 403 Привязка этого устройства отключена — включите её в веб-интерфейсе AiHummer и попробуйте снова. err.pairing.binding_inactive —

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 Указанный объект не существует или вне области видимости.
AIH-SCHEDULE-0002 409 Расписание пока нельзя включить: не выполнены условия err.schedule.blocked —
AIH-SCHEDULE-0003 409 Блокировку снимает действие «Снять блокировку», а не правка данных err.schedule.unblock_required —
AIH-SCHEDULE-0004 400 Выберите получателя: у расписания есть канал доставки, но не указан чат err.schedule.recipient_required —
AIH-SCHEDULE-0006 409 Команды на сервере в расписаниях выключены. Включить их может владелец или администратор в разделе Система и настройки → Расписания. err.schedule.commands_off —
AIH-SCHEDULE-0007 409 Этой точной команды нет среди разрешённых. Добавить её может владелец или администратор в разделе Система и настройки → Расписания. err.schedule.command_not_allowed —
AIH-SCHEDULE-0008 400 Этот чат не может получать сообщения расписаний: у веб-бесед и разговоров через API нет исходящей доставки. Выберите чат мессенджера. err.schedule.recipient_undeliverable —

SCIM

Автоматическое управление пользователями по SCIM.

Код HTTP Значение Ключ i18n Типичная причина
AIH-SCIM-0001 501 SCIM не включён err.scim.not_enabled Функция/интеграция выключена или не настроена.

SECRET — хранилище секретов

Хранилище секретов арендатора. Две разные причины: not_configured — не задан мастер-ключ (задайте AIHUMMER_MASTER_KEY и перезапустите службу); not_found — указанный секрет отсутствует (проверьте имя секрета и рабочее пространство).

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

Админ-поверхность разговоров/сессий и сообщений. Две разные причины с разными действиями: not_enabled — функция разговоров выключена (включите её в настройках); forbidden — разговор или сообщение принадлежит другому владельцу (проверьте пользователя, арендатора и права роли).

Код 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 Ресурс принадлежит другому арендатору/владельцу/сессии.
AIH-SESSION-0004 413 Вложение превышает максимально допустимый размер err.session.attachment_too_large —
AIH-SESSION-0005 404 Вложение не найдено err.session.attachment_not_found —
AIH-SESSION-0006 502 Сообщение не дошло до канала err.session.operator_reply_undelivered —
AIH-SESSION-0007 409 Это сообщение — не ответ агента в чате приложения err.session.not_app_reply —
AIH-SESSION-0008 503 Доставка в приложение на этом экземпляре недоступна err.session.app_delivery_unavailable —
AIH-SESSION-0009 503 Модуль «Приложение AiHummer» не запущен — запустите его на странице «Плагины» и доставьте повторно err.session.app_module_not_running —

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 Функция/интеграция выключена или не настроена.
AIH-SYSTEM-0003 501 Установка сайдкара на этом хосте недоступна — запустите подписанный установщик с --sidecar &lt;имя&gt;. err.system.sidecar_not_configured —
AIH-SYSTEM-0004 501 Этот сервер не умеет перезапускать себя из панели. Сохранённое значение заработает при следующем перезапуске — попросите того, кто занимается сервером, или перезапустите его в панели вашего хостинга. err.system.restart_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

Endpoint голосовой обработки (/v1/voice/turn): обработка аудиозапроса SIP-мост → шлюз.

Код HTTP Значение Ключ i18n Типичная причина
AIH-VOICE-0001 502 Не удалось определить разговор err.voice.resolve_failed Сбой вызова вышестоящего сервиса/провайдера.
AIH-VOICE-0002 502 Сбой голосовой обработки err.voice.turn_failed Сбой вызова вышестоящего сервиса/провайдера.

WEBCONN

Backend Admin Sessions: сессия браузера + SSE. Потоковые SSE-события ошибок не входят в этот конверт.

Код HTTP Значение Ключ i18n Типичная причина
AIH-WEBCONN-0001 403 Разговор не принадлежит вашей сессии err.webconn.forbidden Ресурс принадлежит другому арендатору/владельцу/сессии.
AIH-WEBCONN-0002 500 Потоковая передача не поддерживается err.webconn.streaming_unsupported Непредвиденный внутренний сбой.
AIH-WEBCONN-0003 409 Настройки приложения у этого AI-сотрудника повреждены. Владелец может исправить их в профиле агента: «Контекст и поведение» → «Приложение AiHummer». err.webconn.app_policy_invalid —
AIH-WEBCONN-0004 404 Не найдено err.common.not_found —

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 Ресурс принадлежит другому арендатору/владельцу/сессии.
AIH-WORKSPACE-0002 404 Рабочее пространство не найдено err.workspace.not_found —
AIH-WORKSPACE-0003 409 Нельзя удалить последнее рабочее пространство err.workspace.cannot_delete_last —

ZAPIER

Входящий триггер Zapier-коннектора.

Код HTTP Значение Ключ i18n Типичная причина
AIH-ZAPIER-0001 501 Входящий триггер не настроен err.zapier.not_configured Функция/интеграция выключена или не настроена.
AIH-ZAPIER-0002 401 Неверная подпись или токен триггера err.zapier.invalid_signature Отсутствуют или неверны учётные данные.

ANALYSIS

Код HTTP Значение Ключ i18n Типичная причина
AIH-ANALYSIS-0001 503 Текущий доступ к источнику недоступен. Общий анализ или связь записей не предоставляют прав на исходные данные. businessResults.sourceUnavailable —

BINDING

Код HTTP Значение Ключ i18n Типичная причина
AIH-BINDING-0001 400 Правило привязки некорректно: укажите канал, область действия и ровно одну цель — агента или «не отвечать». err.binding.invalid_rule —
AIH-BINDING-0002 409 Привязка для этой цели уже существует — удалите или измените существующую. err.binding.overlap —
AIH-BINDING-0003 404 Привязка не найдена. err.binding.not_found —
AIH-BINDING-0004 400 @handle — не тот идентификатор, который присылает канал: добавьте человека по числовому id канала. err.binding.handle_not_identity —
AIH-BINDING-0005 409 Эта группа или канал уже подключены к другой организации на этом сервере — закрепить их за агентом здесь нельзя. err.binding.chat_taken —

BROWSER

Код HTTP Значение Ключ i18n Типичная причина
AIH-BROWSER-0001 503 Служба профилей браузера не запущена. Она запускается вместе с браузером. err.browserprofile.service_unavailable —
AIH-BROWSER-0002 409 У этого агента уже есть профиль браузера. Сначала отвяжите агента от него. err.browserprofile.agent_taken —
AIH-BROWSER-0003 409 Профиль сейчас занят: в него кто-то входит. Попробуйте через несколько минут. err.browserprofile.busy —
AIH-BROWSER-0004 409 Профиль ещё открыт в браузере: агент заканчивает в нём действие. Попробуйте через минуту. err.browserprofile.in_use —

CLAIM

Код HTTP Значение Ключ i18n Типичная причина
AIH-CLAIM-0001 409 Окно опознания закрыто — откройте его заново. err.claim.window_closed —
AIH-CLAIM-0002 404 Этот отправитель не писал, пока окно было открыто. err.claim.candidate_unknown —

DATA

Код HTTP Значение Ключ i18n Типичная причина
AIH-DATA-0001 503 Не удалось проверить текущие правила обработки источника. dataPolicy.errorUnavailable —
AIH-DATA-0002 409 Выбранный маршрут обработки не разрешён для этого источника. Выберите уже разрешённый совместимый маршрут или проверьте правило источника. dataPolicy.errorIncompatible —
AIH-DATA-0003 503 Для этой операции не настроен проверенный совместимый маршрут. Укажите место обработки и профиль сохранения данных. dataPolicy.errorUnconfigured —
AIH-DATA-0004 409 Маршрут обработки изменился во время операции. Проверьте текущий маршрут перед новым явным запросом. dataPolicy.errorChanged —
AIH-DATA-0005 409 У прежних данных нет проверенной классификации источника. Место обработки не предполагается автоматически. Используйте новый контекст или проверьте классификацию исходного материала. dataPolicy.errorProvenanceUnknown —
AIH-DATA-0006 409 Не удалось проверить исходные байты вложения для этого запроса. Откройте существующее вложение перед новой попыткой. dataPolicy.errorFingerprintUnavailable —
AIH-DATA-0007 409 Настройки обработки изменились. Перечитайте текущую версию перед сохранением. dataPolicy.errorConfigurationChanged —

DELEGATION

Код HTTP Значение Ключ i18n Типичная причина
AIH-DELEGATION-0001 403 Это внешнее подключение сейчас не назначено данному пользователю и агенту. enterpriseConnections.errorDenied —
AIH-DELEGATION-0002 409 Внешняя личность, подключение или полномочия изменились. Загрузите текущее подключение заново. enterpriseConnections.errorChanged —
AIH-DELEGATION-0003 503 Настроенный issuer, версия поставщика или профиль делегации недоступен либо несовместим. enterpriseConnections.errorUnavailable —
AIH-DELEGATION-0004 409 Для прежней выдачи внешнего токена нет подтверждённого результата. Перед новой попыткой проверьте фактическую выдачу у поставщика. enterpriseConnections.errorReconcile —
AIH-DELEGATION-0005 409 Конфигурация корпоративных подключений изменилась. Перед сохранением загрузите текущую редакцию. enterpriseConnections.errorConfigurationChanged —

DEMO

Код HTTP Значение Ключ i18n Типичная причина
AIH-DEMO-0001 403 Это действие отключено на публичном демо-стенде err.demo.restricted —
AIH-DEMO-0002 403 Это часть самого демо-стенда: удалить или остановить нельзя err.demo.protected —
AIH-DEMO-0003 403 Уведомления по email на публичном демостенде выключены, включить их нельзя err.demo.email_disabled —

IMPORT

Код HTTP Значение Ключ i18n Типичная причина
AIH-IMPORT-0001 409 Часть не продолжает загрузку; загрузка продолжится с места, до которого дошёл сервер err.import.upload_offset —
AIH-IMPORT-0002 422 Загруженный файл отличается от файла на вашем компьютере. Загрузите его заново err.import.upload_checksum —
AIH-IMPORT-0003 413 Выгрузка больше, чем допускает импорт err.import.too_large —
AIH-IMPORT-0004 507 На сервере не хватает места для выгрузки и её распаковки err.import.no_space —
AIH-IMPORT-0005 422 В архиве есть пути за его пределы — он не распакован err.import.unsafe_archive —
AIH-IMPORT-0006 422 Ни один источник импорта не узнал эту выгрузку err.import.not_recognized —
AIH-IMPORT-0007 409 Загрузка ещё не завершена err.import.upload_incomplete —
AIH-IMPORT-0008 424 Резервная копия базы перед импортом не снялась — ничего не применено. Проверьте, что на сервере установлен pg_dump err.import.backup_failed —

NOTIFY

Код HTTP Значение Ключ i18n Типичная причина
AIH-NOTIFY-0001 501 Уведомления не включены err.notify.not_enabled —
AIH-NOTIFY-0002 400 Некорректная настройка уведомления err.notify.invalid_pref —
AIH-NOTIFY-0003 503 Привязка Telegram недоступна err.notify.telegram_unavailable —
AIH-NOTIFY-0004 502 Не удалось проверить статус Telegram — повторите попытку err.notify.telegram_transient —

ONBOARDING

Код HTTP Значение Ключ i18n Типичная причина
AIH-ONBOARDING-0001 503 Отсутствует подключение к серверам aihummer.ru. Для продолжения регистрации инстанса проверьте подключение к сети интернет. err.onboarding.awaiting_fleet —
AIH-ONBOARDING-0002 400 Идентификатор владельца должен быть в формате UUID err.onboarding.invalid_owner —

PLAN

Код HTTP Значение Ключ i18n Типичная причина
AIH-PLAN-0001 402 Этот AI-сотрудник вне лимита действующего тарифа. Продлите подписку, чтобы он снова отвечал. err.plan.agent_over_limit —

ROLE

Код HTTP Значение Ключ i18n Типичная причина
AIH-ROLE-0001 400 Некорректное описание роли err.role.invalid —
AIH-ROLE-0002 409 Роль с таким именем уже существует err.role.exists —
AIH-ROLE-0003 404 Роль не найдена err.role.not_found —
AIH-ROLE-0004 400 Встроенные роли изменять нельзя err.role.builtin_readonly —
AIH-ROLE-0005 409 Роль ещё назначена пользователям — сначала отзовите её err.role.in_use —

SETTINGS

Код HTTP Значение Ключ i18n Типичная причина
AIH-SETTINGS-0001 403 Эта настройка управляется AiHummer Cloud и недоступна для изменения err.settings.cloud_locked —
AIH-SETTINGS-0002 400 Режим «Только в песочнице» не сохранён: песочница ОС (bubblewrap) на этом сервере не запускается, а образ контейнера не задан. Установите bubblewrap или выберите «На этом сервере». err.settings.code_exec_sandbox_unavailable —

SUPPORT

Код HTTP Значение Ключ i18n Типичная причина
AIH-SUPPORT-0001 503 Нет связи с вендором — шина недоступна. Повторите позже. err.support.unavailable —
AIH-SUPPORT-0002 400 Сервис поддержки отклонил запрос err.support.rejected —

TURN

Код HTTP Значение Ключ i18n Типичная причина
AIH-TURN-0001 502 Провайдер модели отклонил учётные данные err.turn.provider_auth —
AIH-TURN-0002 429 Запрос ограничен провайдером или политикой бюджета err.turn.rate_limited —
AIH-TURN-0003 502 Необходимый сервис временно недоступен err.turn.upstream_unavailable —
AIH-TURN-0004 502 Сбой инструмента, необходимого для этого хода err.turn.tool_failed —
AIH-TURN-0005 502 Задача не уместилась в предел шагов одного хода err.turn.step_limit —
AIH-TURN-0006 502 Разговор больше не помещается в окно контекста модели err.turn.context_overflow —
AIH-TURN-0007 503 Ход по расписанию прервался при перезапуске сервера err.turn.interrupted_restart —
AIH-TURN-0008 503 Сервер занят другими ответами — сообщение не обработано. Отправьте его ещё раз. err.turn.server_busy —
AIH-TURN-0009 409 Этап задачи остановлен. Проверьте текущее состояние задачи. err.turn.task_stopped —