Коды ошибок Telegram API

В данной статье собраны ошибки, возвращаемые API Telegram. Числовое значение аналогично статусу HTTP. Содержит информацию о типе возникшей ошибки: например, ошибка ввода данных, ошибка конфиденциальности или ошибка сервера.

303 SEE_OTHER

Запрос необходимо повторить, но направить в другой центр обработки данных.

Примеры ошибок:

• FILE_MIGRATE_X: файл, к которому нужно получить доступ, в настоящее время хранится в другом центре обработки данных.
• PHONE_MIGRATE_X: номер телефона, который пользователь пытается использовать для авторизации, связан с другим центром обработки данных.
• NETWORK_MIGRATE_X: исходный IP-адрес связан с другим центром обработки данных (для регистрации)
• USER_MIGRATE_X: пользователь, личность которого используется для выполнения запросов, связан с другим центром обработки данных (для регистрации)

Во всех этих случаях строковый литерал описания ошибки содержит номер центра обработки данных (вместо X), в который должен быть отправлен повторный запрос.

ОШИБКА 400, НЕВЕРНЫЙ ЗАПРОС

Запрос содержит ошибки. В случае, если запрос был создан с использованием формы и содержит данные, созданные пользователем, пользователь должен быть уведомлен о том, что данные должны быть исправлены, прежде чем запрос будет повторен.

Примеры ошибок:

• FIRSTNAME_INVALID: имя недействительно
• LASTNAME_INVALID: фамилия недействительна
• PHONE_NUMBER_INVALID: номер телефона недействителен
• PHONE_CODE_HASH_EMPTY: phone_code_hash отсутствует
• PHONE_CODE_EMPTY: phone_code отсутствует
• PHONE_CODE_EXPIRED: срок действия кода подтверждения истек
• API_ID_INVALID: комбинация api_id / api_hash недействительна
• PHONE_NUMBER_OCCUPIED: номер телефона уже используется
• PHONE_NUMBER_UNOCCUPIED: номер телефона еще не используется
• USERS_TOO_FEW: недостаточно пользователей (например, для создания чата)
• USERS_TOO_MUCH: превышено максимальное количество пользователей (например, для создания чата)
• TYPE_CONSTRUCTOR_INVALID: конструктор типа недействителен
• FILE_PART_INVALID: неверный номер части файла.
• FILE_PARTS_INVALID: недопустимое количество частей файла.
• FILE_PART_Х_MISSING: часть X (где X - номер) файла отсутствует в хранилище
• MD5_CHECKSUM_INVALID: контрольные суммы MD5 не совпадают
• PHOTO_INVALID_DIMENSIONS: размеры фотографии недействительны
• FIELD_NAME_INVALID: поле с именем FIELD_NAME недействительно
• FIELD_NAME_EMPTY: поле с названием FIELD_NAME отсутствует
• MSG_WAIT_FAILED: запрос, который должен быть выполнен перед обработкой текущего запроса, возвратил ошибку
• MSG_WAIT_TIMEOUT: запрос, который должен быть выполнен перед обработкой текущего запроса, еще не завершил обработку

401 ОШИБКА ДОСТУПА

Произошла попытка несанкционированного использования функций, доступных только авторизованным пользователям.

Примеры ошибок:

• AUTH_KEY_UNRIGN: Ключ не зарегистрирован в системе
• AUTH_KEY_INVALID: ключ недействителен
• USER_DEACTIVATED: пользователь удален / деактивирован
• SESSION_REVOKED: авторизация была аннулирована из-за того, что пользователь завершил все сеансы
• SESSION_EXPIRED: срок авторизации истек
• AUTH_KEY_PERM_EMPTY: метод недоступен для временного ключа авторизации, не привязан к постоянному

403 ЗАПРЕЩЕНО

Нарушение конфиденциальности. Например, попытка написать сообщение кому-то, кто занес текущего пользователя в черный список.

404 НЕ НАЙДЕНО

Попытка вызвать несуществующий объект, например метод.

406 NOT_ACCEPTABLE

Подобно 400 BAD_REQUEST , но приложение не должно отображать сообщения об ошибках для пользователя в пользовательском интерфейсе в результате этого ответа. Вместо этого сообщение об ошибке будет доставлено через updateServiceNotification.

420 FLOOD

Превышено максимально допустимое количество попыток вызвать данный метод с заданными входными параметрами. Например, при попытке запросить большое количество текстовых сообщений (SMS) на один и тот же номер телефона.

Пример ошибки:

• FLOOD_WAIT_X: требуется ожидание X секунд (где X - число)

500 ВНУТРЕННИЙ

Произошла внутренняя ошибка сервера во время обработки запроса; например, произошел сбой при доступе к базе данных или файловому хранилищу.

Если клиент получает ошибку 500 или вы считаете, что эта ошибка не должна была возникнуть, пожалуйста, соберите как можно больше информации о запросе и ошибке и отправьте ее разработчикам.

Другие коды ошибок

Если сервер возвращает ошибку с кодом, отличным от перечисленных выше, это может рассматриваться как ошибка 500 и рассматриваться как внутренняя ошибка сервера.