Overview
REST API BroadNet сообщает об ошибках со стандартным HTTP кодом состояния и JSON телом, называемым ExceptionResponse, содержащим пять полей: status, error, message, errorCode и requestUri. Сначала выполняется сопоставление по HTTP статусу, затем по errorCode. Одно исключение: отсутствующий или недействительный токен Bearer отклоняется ранее, на шлюзе API, с кодом 401, тело которого содержит только error и message.
Коды состояния
Код 400 означает ошибку проверки или отсутствие обязательного поля: исправьте запрос. Код 401 означает отсутствие или недействительность токена Bearer, а код 403 означает, что вызов операции запрещен: исправьте токен. Код 500 означает непредвиденную ошибку сервера, а код 502 означает, что вышестоящий провайдер отклонил вызов: повторите попытку с экспоненциальной задержкой. Привязки SMPP возвращают стандартные коды SMPP command_status.
Примеры
Скопируйте, вставьте, замените заполнители — примеры обращаются к production API как есть.
{
"status": 400,
"error": "Bad Request",
"message": "…",
"errorCode": "…",
"requestUri": "/sms/sendSms"
}{
"error": "Unauthorized",
"message": "Missing Authorization token"
}