HTTP Status Codes

При интеграции с HTTP REST API для отправки SMS и других сообщений важно учитывать коды состояния HTTP, которые возвращает сервер. Эти коды позволяют определить, успешно ли обработан запрос, произошла ли ошибка, требуется ли дополнительная аутентификация или имеются проблемы с сервером.

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

Категории HTTP-статусов

Все HTTP-коды делятся на несколько классов:

1xx (Информационные коды) – сервер принял запрос, но обработка еще не завершена.
2xx (Успешные коды) – запрос обработан успешно.
3xx (Перенаправления) – запрашиваемый ресурс доступен по другому адресу.
4xx (Ошибки клиента) – запрос содержит ошибку или клиент не имеет прав для выполнения операции.
5xx (Ошибки сервера) – сервер не может обработать запрос из-за внутренней ошибки.

Основные HTTP-коды, используемые в API для SMS

Коды успешных запросов (2xx)

Эти коды указывают на то, что запрос успешно обработан сервером.

Код	Название	Описание
200 OK	Успешный запрос	Сообщение принято сервером и обработано.
201 Created	Создано	Сообщение успешно создано (например, добавлено в очередь на отправку).
202 Accepted	Принято	Запрос принят, но обработка еще не завершена (асинхронная обработка сообщений).
204 No Content	Без содержимого	Запрос выполнен, но в ответе нет данных (например, удаление записи).

Код 200 OK наиболее часто встречается в API для SMS и означает, что сервер успешно обработал запрос и отправил ответ.

Коды ошибок клиента (4xx)

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

Код	Название	Описание
400 Bad Request	Неверный запрос	Сервер не смог обработать запрос из-за синтаксической ошибки.
401 Unauthorized	Нет авторизации	Запрос требует авторизации, но учетные данные отсутствуют или неверны.
403 Forbidden	Доступ запрещен	Учетные данные верны, но доступ к ресурсу запрещен.
404 Not Found	Не найдено	Запрашиваемый ресурс не существует (например, несуществующий номер SMS).
405 Method Not Allowed	Метод не поддерживается	Метод HTTP (GET, POST, PUT, DELETE) не разрешен для данного ресурса.
429 Too Many Requests	Слишком много запросов	Превышено ограничение на количество запросов API.

Часто встречающийся код 401 Unauthorized означает, что при вызове API не были переданы корректные учетные данные. В этом случае необходимо проверить API-ключ или токен аутентификации. Код 429 Too Many Requests говорит о том, что клиент отправляет слишком много запросов за короткий промежуток времени, и следует уменьшить частоту вызовов.

Коды ошибок сервера (5xx)

Ошибки сервера указывают на проблемы на стороне API-провайдера.

Код	Название	Описание
500 Internal Server Error	Внутренняя ошибка сервера	Общая ошибка сервера, требующая анализа логов.
502 Bad Gateway	Ошибочный шлюз	Проблема на уровне прокси-сервера или шлюза API.
503 Service Unavailable	Сервис недоступен	Сервер перегружен или временно отключен на обслуживание.
504 Gateway Timeout	Истекло время ожидания	Запрос не был обработан из-за тайм-аута на уровне шлюза.

Ошибка 500 Internal Server Error является наиболее общей и может быть вызвана разными проблемами, включая сбои в базе данных или внутренних сервисах. Если сервер API возвращает 503 Service Unavailable, это может означать временную недоступность сервиса, например, во время технического обслуживания.

Как правильно обрабатывать HTTP-статусы в API для SMS

Проверять коды ошибок 4xx перед повторной отправкой.
Если сервер возвращает 400 Bad Request, это означает, что запрос содержит ошибку. В таком случае важно исправить параметры запроса перед повторной попыткой.
Настроить повторные попытки при ошибках 5xx.
Ошибки 500, 502, 503 могут быть временными, поэтому рекомендуется реализовать механизм автоматической повторной отправки с задержкой.
Следить за ограничениями частоты запросов.
Если сервер возвращает 429 Too Many Requests, необходимо снизить частоту вызовов API и использовать стратегию Rate Limiting.
Использовать логирование HTTP-кодов.
Запись всех HTTP-ответов в журнал позволяет быстрее выявлять ошибки интеграции и находить проблемы с доставкой сообщений.

HTTP-коды состояния играют ключевую роль при интеграции с API для отправки SMS. Они позволяют быстро определять причины ошибок, понимать, успешно ли обработан запрос, и реагировать на возможные проблемы с соединением, аутентификацией или серверной нагрузкой.

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

Дополнительные ресурсы

При возникновении вопросов по обработке HTTP-кодов в API обратитесь в техническую поддержку.