Проверка статуса сообщения SMS

Метод sms-status предназначен для получения информации о состоянии сообщения SMS.

Параметры запроса

Параметр	Тип	Обязательный	Описание
id	string	Да	Идентификатор SMS

Пример запроса

{
    "api_key": "541eab8c-3e2f-5c47-3278-37206b391dd0",
    "action": "sms-status",
    "data": {
        "id": "0cd2d91a-559a-4e11-8bb7-ebdbaa4f324a"
    }
}

Параметры ответа

Параметр	Тип	Описание
id	string	Идентификатор SMS
created	datetime	Дата и время создания SMS в формате ISO 8601
updated	datetime	Дата и время обновления SMS в формате ISO 8601
signature	string	Подпись отправителя SMS
phone	string	Номер телефона в международном формате
message	string	Текст сообщения SMS
parts	integer	Количество частей SMS
price	double	Стоимость одной части SMS
total	double	Полная стоимость SMS
status	string	Статус SMS
paused	boolean	Приостановка отправки SMS
paid	boolean	Состояние списания средств за SMS

Пример ответа

{
    "success": true,
    "data": {
        "id": "0cd2d91a-559a-4e11-8bb7-ebdbaa4f324a",
        "created": "2024-01-31T08:10:32+03:00",
        "updated": "2024-01-31T08:12:48+03:00",
        "signature": "TestSMS",
        "phone": "+79401234567",
        "message": "SMS test message",
        "parts": 1,
        "price": 2.49,
        "total": 2.49,
        "status": "delivered",
        "paused": false,
        "paid": true
    }
}

Возможные статусы

Статус	Описание
cancel	Отмененяется
cancelled	Отменено
deleted	Удалено
delivered	Успешно доставлено
enroute	Отправлено на шлюз
error	Не может быть доставлено, обнаружена ошибка
expired	Истек срок жизни
init	Подготавливается к отправке
noroute	Не может быть доставлено, маршрут не найден
ready	Готово к отправке
rejected	Отклонено
reserve	Заблокирована стоимость на балансе пользователя
route	Маршрутизируется
undeliverable	Не может быть доставлено
unknown	Неизвестное состояние
unpaid	Не может быть обработано, недостаточно средств

Возможные ошибки

Ошибка	Описание
SMS-STATUS-ID-REQUIRED	Не указан параметр id
SMS-STATUS-ID-INVALID-TYPE	Параметр id имеет недопустимый тип
SMS-STATUS-ID-INVALID-FORMAT	Параметр id не соответствует формату
SMS-STATUS-ID-NOT-FOUND	SMS не найдено