https://letsads.com/sozdat-sms-rassylku
Для восстановления пароля введите номер телефона, указанный при регистрации.
Код для восстановления пароля был отправлен на номер телефона, указанный при регистрации.
Введите новый пароль и подтвердите его. Запомните его и используйте для входа на сайт.

Sms API

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

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

Пример запроса на рассылку сообщения по 4-м респондентам:
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <request>
  3. <auth>
  4. <login>380501234567</login>
  5. <password>p1a2s3s4</password>
  6. </auth>
  7. <message>
  8. <from>Sender</from>
  9. <text>Тестовое сообщение.</text>
  10. <recipient>380501234567</recipient>
  11. <recipient>380501234569</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>
Коды ошибок:
  • NO_DATA (ошибка данных: не передан XML)
  • WRONG_DATA_FORMAT (ошибка формата переданного XML)
  • REQUEST_FORMAT (неправильный тип запроса)
  • AUTH_DATA (ошибка авторизации: несуществующий пользователь, неправильная пара логин-пароль)
  • API_DISABLED (для учетной записи пользователя запрещена работа с API)
  • USER_NOT_MODERATED (запрещена отправка сообщений без проверки для учетной записи пользователя)
  • INCORRECT_FROM (некорректное имя отправителя)
  • INVALID_FROM (несуществующее имя отправителя для данной учетной записи)
  • MESSAGE_TOO_LONG (превышена максимальная длина сообщения: 402 для кириллицы, 459 для латиницы)
  • NO_MESSAGE (пустое сообщение для оправки)
  • MAX_MESSAGES_COUNT (превышено максимальное количество респондентов в одном запросе: 50)
  • NOT_ENOUGH_MONEY (недостаточно средств для отправки сообщения респондентам в запросе)
  • UNKNOWN_ERROR (неизвестная ошибка)
  • INCORRECT_RECIPIENT_ (укажет первый неправильный номер из списка, который нужно исключить и повторно отправить запрос; не отправит смс всем из списка)

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

Пример запроса на получение статуса по 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>
Возможные статусы:
  • MESSAGE_IS_DELIVERED (сообщение доставлено респонденту)
  • MESSAGE_IS_SENT (сообщение отправлено)
  • MESSAGE_NOT_DELIVERED (сообщение не доставлено)
  • MESSAGE_IN_QUEUE (сообщение поставлено в очередь на отправку)
Если были ошибки:
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <response>
  3. <name>Error</name>
  4. <description>Код ошибки</description>
  5. </response>
Коды ошибок:
  • NO_DATA (ошибка данных: не передан XML)
  • WRONG_DATA_FORMAT (ошибка формата переданного XML)
  • REQUEST_FORMAT (неправильный тип запроса)
  • AUTH_DATA (ошибка авторизации: несуществующий пользователь, неправильная пара логин-пароль)
  • API_DISABLED (для учетной записи пользователя запрещена работа с API)
  • MESSAGE_NOT_EXIST (сообщение с заданным id не существует)
  • UNKNOWN_ERROR (неизвестная ошибка)
Первый раз статус сообщения должен проверяеться через 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>
Коды ошибок:
  • NO_DATA (ошибка данных: не передан XML)
  • WRONG_DATA_FORMAT (ошибка формата переданного XML)
  • REQUEST_FORMAT (неправильный тип запроса)
  • AUTH_DATA (ошибка авторизации: несуществующий пользователь, неправильная пара логин-пароль)
  • API_DISABLED (для учетной записи пользователя запрещена работа с API)
  • UNKNOWN_ERROR (неизвестная ошибка)

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


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

    
$rCurl curl_init($sUrl);
    
curl_setopt($rCurlCURLOPT_HEADER0);
    
curl_setopt($rCurlCURLOPT_POSTFIELDS$sXML);
    
curl_setopt($rCurlCURLOPT_RETURNTRANSFER1);
    
curl_setopt($rCurlCURLOPT_POST1);
    
$sAnswer curl_exec($rCurl);
    
curl_close($rCurl);