Ошибки и лимиты

Коды ошибок клиентского API и рекомендации по обработке.

Код
HTTP
Описание
Что делать

INVALID_ARGUMENT

400

Неверные или отсутствующие поля.

Проверить bot_id, user_tg_id, типы данных.

UNAUTHORIZED

401

Нет или неверный bearer токен.

Убедиться, что передаёте правильный api_token.

FORBIDDEN

403

bot_id не соответствует токену.

Использовать токен именно этого бота.

BOT_NOT_FOUND

404

Бот не зарегистрирован/выключен.

Убедиться, что бот активирован на стороне central API/аккаунта, при необходимости обратиться в поддержку.

CODE_ALLOCATION_FAILED

500

Не удалось сгенерировать уникальный код.

Повторить запрос позже; если повторяется — сообщить в поддержку.

INTERNAL

500

Временная ошибка сервера.

Повторить запрос с экспоненциальной задержкой.

Рекомендуем ограничивать частоту вызовов и ретраи (500) с backoff, чтобы не усугублять нагрузку.

Последнее обновление