Получение статусов сообщений
SMS, Viber, VK, «каскад»

Получение статуса сообщения в формате JSON

Запрос:

> POST https://auth.terasms.ru/outbox/getstatus/json

{
    "login": "login",
    "message_ids": [11222, 11223],
    "sign": "fa129981b8d66bada6dd186711dc23ab"
}

Ответ:

{
    "statuses": [
        {
            "message_id": 11222,
            "country": "страна/оператор",
            "status": 12,
            "status_desc": "delivered",
            "type": "sms",
            "method": "sms",
            "time_seen": "",
            "segments": [
                {
                    "segment_id": "112221",
                    "status": "12",
                    "status_desc": "delivered"
                },
                {
                    "segment_id": "112222",
                    "status": "12",
                    "status_desc": "delivered"
                }
            ]
        },
        {
            "message_id": 11223,
            "country": "страна/оператор",
            "status": 18,
            "status_desc": "rejected",
            "type": "viber",
            "method": "viber",
            "time_seen": "2100-03-04 22:45:32"
        }
    ]
}

Получение статуса сообщения в формате XML

Запрос:

> POST https://auth.terasms.ru/outbox/getstatus/xml

<request>
    <login>login</login>
    <message_ids>
        <message_id>11222</message_id>
        <message_id>11223</message_id>
    </message_ids>
    <sign>fa129981b8d66bada6dd186711dc23ab</sign>
</request>

Ответ:

<response>
    <statuses>
        <status>
            <message_id>11222</message_id>
            <country>страна/оператор</country>
            <status>12</status>
            <status_desc>delivered</status_desc>
            <type>sms</type>
            <method>sms</method>
            <time_seen/>
            <segments>
                <segment>
                    <segment_id>112221</segment_id>
                    <status>12</status>
                    <status_desc>delivered</status_desc>
                </segment>
                <segment>
                    <segment_id>112222</segment_id>
                    <status>12</status>
                    <status_desc>delivered</status_desc>
                </segment>
            </segments>
        </status>
        <status>
            <message_id>11223</message_id>
            <country>страна/оператор</country>
            <status>18</status>
            <status_desc>rejected</status_desc>
            <type>viber</type>
            <method>viber</method>
            <time_seen>2100-03-04 22:45:32</time_seen>
        </status>
    </statuses>
</response>

Статусы сообщений

Статус	Код	Описание	Тип
В очереди (queued)	0	Сообщение принято и ожидает отправки оператору связи.	Промежуточный
Отправлено (sent)	1	Сообщение принято и отправлено оператору связи. Сообщение может иметь этот статус в случае: - не получен статус сообщения от оператора связи; - телефон абонента выключен или находится вне зоны действия сети; - память телефона переполнена. Стандартное время при котором предпринимаются попытки доставить сообщение 24 часа.	Промежуточный
Доставлено (delivered)	12	Сообщение доставлено на телефон.	Конечный
Просрочено (expired)	13	Были предприняты попытки доставить сообщение в течение допустимого времени, но срок истек и сообщение не было доставлено Возможные причины: - телефон абонента был выключен или находился вне зоны действия сети в течение возможного времени доставки; - память телефона переполнена и не была освобождена в течение возможного времени доставки.	Конечный
Не доставлено (not_delivered)	15	Сообщение не доставлено на телефон. Повторные попытки доставить сообщение предприниматься не будут. Возможные причины: - номер не существует; - абонент заблокирован; - запрет приема сообщений.	Конечный
Неизвестный статус (unknown)	17	Не был получен статус доставки сообщения от оператора связи. Возможные причины: - оператор связи не предоставляет информацию о статусе доставки; - ошибка на стороне оператора.	Конечный
Отказ в передаче (rejected)	18	Получен отказ в передаче от оператора, сообщение не доставлено. Возможные причины: - спам-фильтр; - неправильный формат номера абонента; - неправильный формат имени отправителя; - неправильный формат сообщения.	Конечный
Просмотрено абонентом (read)	20	Сообщение было получено и открыто получателем. Не применимо для SMS-сообщений.	Конечный
Недействительно (error)	255	Сообщение было отбито со стороны шлюза.	Конечный