Платформой предусмотрена возможность отправки «каскадных» сообщений. Процедура отправки сообщения выглядит следующим образом:
- Предпринимается попытка отправить PUSH-уведомление
- В случае недоставки или в случае, если отправку PUSH-уведомлений отключена отправляется Viber-сообщение
- В случае недоставки Viber сообщения отправляется СМС
Отправка «каскадных» сообщений осуществляется аналогично отправке SMS, при этом в список передаваемых параметров добавляется параметр cascade со значением 1
Отправка «каскадного» сообщения GET-запросом: https://auth.terasms.ru/outbox/send?login=login&ta... rulez&cascade=1&sign=3e6eb14d4b7c06d77aecd92904d964c2
Описание параметров
Формат ответа аналогичен ответу при отправке SMS: либо ID сообщения в виде положительного числа, либо ошибка в виде отрицательного числа.
Запрос в формате JSON:
Пример запроса:
> POST auth.terasms.ru/outbox/send/json {
"login":
"login",
"sign":
"3e6eb14d4b7c06d77aecd92904d964c2",
"target":
78002223344,
"message":
"terasms rulez",
"sender":
"terasms.ru",
"cascade":
1, } Пример ответа:
{
"status":
0,
"status_description":
"OK",
"message_infos": [ {
"msisdn":
"78002223344",
"id":
"566668915",
"status":
0 } ] } Получение статусов
Получение статуса сообщения в формате JSON: Запрос:
> POST
https://auth.terasms.ru/outbox/getstatus/json {
"login":
"login",
"message_ids": [
11222,
11223],
"sign":
"fa129981b8d66bada6dd186711dc23ab" } Ответ:
[ {
"message_id":
11222,
"status":
12,
"status_description":
"delivered",
"type":
"cascade", }, {
"message_id":
11222,
"status":
18,
"status_description":
"rejected",
"type":
"sms", } ] Получение статуса сообщения в формате 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> <status>12
</status> <status_description>delivered
</status_description> <type>cascade
</type> </status> <status> <message_id>11223
</message_id> <status>18
</status> <status_description>rejected
</status_description> <type>sms
</type> </status> </statuses> <response> Описание статусов: