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 | Сообщение было отбито со стороны шлюза. | Конечный |