Коды ошибок сервера авторизации

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Сервер авторизации oauth.bitrix24.tech возвращает код ошибки в поле error, а пояснение — в поле error_description. Ошибка приходит вместо пары токенов — при обмене авторизационного кода или при продлении токенов.

{
    "error": "PAYMENT_REQUIRED",
    "error_description": "Payment required"
}

Код

Описание

Что делать

invalid_request

Передан некорректно сформированный авторизационный запрос

Проверьте состав и написание параметров запроса

invalid_client

Переданы некорректные данные клиента. Возможно, приложение не установлено в Битрикс24

Проверьте client_id и client_secret, убедитесь, что приложение установлено в этом Битрикс24

insufficient_scope или invalid_scope

Запрошены права доступа свыше указанных в карточке приложения

Добавьте недостающие права в карточку приложения

invalid_grant

Переданы некорректные авторизационные данные для получения access_token. Возникает при первом получении токенов и при продлении

Если истек refresh_token, пройдите авторизацию заново по полному протоколу

PAYMENT_REQUIRED

Истек пробный или оплаченный период приложения

Продлите оплату приложения. До этого сервер авторизации токены не выдаст

Ошибки, которые возвращает сам Битрикс24 при вызове методов, — например expired_token при истекшем access_token — собраны в общем списке Коды ошибок.

Предыдущая
Автоматическое продление токенов
Следующая
Варианты установки