Sms API

Мы открываем Вам дополнительные возможности с помощью подключения к нашему сервису по Sms API. Теперь Вы имеете возможность интегрироваться с нашей платформой и полностью автоматизировать процессы рассылки смс.

Отправка сообщения

Пример запроса на рассылку сообщения по 4-м респондентам: 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <request>
  3.     <auth>
  4.         <login>79261234567</login>
  5.         <password>p1a2s3s4</password>
  6.     </auth>
  7.     <message>
  8.         <from>Sender</from>
  9.         <text>Тестовое сообщение.</text>
  10.         <recipient>79161234567</recipient>
  11.         <recipient>79161234569</recipient>
  12.         <recipient>380677654323</recipient>
  13.         <recipient>380677654324</recipient>
  14.     </message>
  15. </request>
Если сообщение было поставлено в очередь успешно будет дан следующий ответ, с указанием id сообщений: 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <response>
  3.     <name>Complete</name>
  4.     <description>4 messages put into queue</description>
  5.     <sms_id>633217</sms_id>
  6.     <sms_id>633218</sms_id>
  7.     <sms_id>633219</sms_id>
  8.     <sms_id>633220</sms_id>
  9. </response>
Если были ошибки: 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <response>
  3.     <name>Error</name>
  4.     <description>Код ошибки</description>
  5. </response>
Коды ошибок:

Получение статуса сообщения

Пример запроса на получение статуса по id сообщения: 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <request>
  3.     <auth>
  4.         <login>380671234567</login>
  5.         <password>p1a2s3s4</password>
  6.     </auth>
  7.     <sms_id>632647</sms_id>
  8. </request>
Если сообщение найдено будет дан ответ с указанием статуса: 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <response>
  3.     <name> Status</name>
  4.     <description>Статус сообщения</description>
  5. </response>
Возможные статусы: Если были ошибки: 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <response>
  3.     <name>Error</name>
  4.     <description>Код ошибки</description>
  5. </response>
Коды ошибок: Первый раз статус сообщения должен проверяеться через 10 минут, второй раз через 3 часа.

Получение баланса пользователя

Пример запроса на получение баланса: 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <request>
  3.     <auth>
  4.         <login>380671234567</login>
  5.         <password>p1a2s3s4</password>
  6.     </auth>
  7.     <balance />
  8. </request>
Ответ: 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <response>
  3.     <name>Balance</name>
  4.     <description>Количество средств на счету пользователя</description>
  5.     <currency>Валюта счета пользователя</currency>
  6. </response>
Если были ошибки: 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <response>
  3.     <name>Error</name>
  4.     <description>Код ошибки</description>
  5. </response>
Коды ошибок:

Пример кода для отправки запроса и получения ответа в формате XML на языке PHP

<?php
$sUrl  = 'http://letsads.com/api';
$sXML  = '<?xml version="1.0" encoding="UTF-8"?>
<request>
    <auth>
        <login>79261234567</login>
        <password>p1a2s3s4</password>
    </auth>
    <balance />
</request>';

$rCurl = curl_init($sUrl);
curl_setopt($rCurl, CURLOPT_HEADER, 0);
curl_setopt($rCurl, CURLOPT_POSTFIELDS, $sXML);
curl_setopt($rCurl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rCurl, CURLOPT_POST, 1);
$sAnswer = curl_exec($rCurl);
curl_close($rCurl);
?>