PromoSMS API

Отправка SMS

Запрос:

POST https://api.unibell.ru/smw/aisms

Параметры могут передаваться в теле запроса:

POST https://api.unibell.ru/smw/aisms?action=post_sms&sender=TEST&target=7XXXXXXXXXX&message=Test&user=login&pass=password

А также в формате x-www-form-urlencoded:

Пример запросов с использованием CURL:

curl --location --request POST 'https://api.unibell.ru/smw/aisms?action=post_sms&sender=TEST&target=7XXXXXXXXXX&message=Test&user=login&pass=password'

curl --location 'https://api.unibell.ru/smw/aisms' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'user=login' \
--data-urlencode 'pass=password' \
--data-urlencode 'action=post_sms' \
--data-urlencode 'message=test' \
--data-urlencode 'target=+7XXXXXXXXXX, 7XXXXXXXXXX' \
--data-urlencode 'sender=TEST'

Параметр	Тип	Описание
user	string	Логин, указанный при HTTP-подключении с авторизацией типа «Basic Auth»
pass	string	Пароль, указанный при HTTP-подключении с авторизацией типа «Basic Auth»
gzip	string	Если указано ‘none’, заголовок content-encoding: gzip не используется
action	string	Для отправки SMS значение должно быть post_sms
message	string	Текст сообщения, которое будет отправлено
target	string	Список получателей, разделенный запятыми (например: +71234567890, 71234567890)
sender	string	Имя отправителя. Если не указано, по умолчанию используется ‘Unibell’ *Поле не должно содержать кириллицы*

Тело ответа:

<output>
    <result>
        <sms id="10473" phone="7XXXXXXXXXX" />
        <sms id="10474" phone="7XXXXXXXXXX" />
    </result>
    <errors>
        <error phone="1">Неправильный номер телефона: 1</error>
        <error phone="zz">Неправильный номер телефона: zz</error>
    </errors>
</output>

При ошибке в sender:

{
    "status": "invalidDataError",
    "error": "Field sender must not contain Cyrillic"
}

Параметр	Тип	Описание
status	string	Статус запроса
reference	string	Уникальный идентификатор сообщения
error	string	Поле sender не должно содержать кириллицы

Получение отчетов о доставке SMS

Запрос:

POST https://api.unibell.ru/smw/aisms?action=status&sms_id=11003&user=user123&pass=pass123

Пример запросов с использованием CURL:

curl --location --request POST 'https://api.unibell.ru/smw/aisms?action=status&sms_id=11003&user=user123&pass=pass123'

curl --location 'https://api.unibell.ru/smw/aisms' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'user=login' \
--data-urlencode 'pass=password' \
--data-urlencode 'action=status' \
--data-urlencode 'sms_id=152'

В процессе доставки или ошибки:

<output>
    <MESSAGES>
        <MESSAGE SMS_ID="11003">
            <SMS_STATUS>1000000</SMS_STATUS>
            <SMSSTC_CODE>queued</SMSSTC_CODE>
            <SMS_SENT>0</SMS_SENT>
        </MESSAGE>
    </MESSAGES>
</output>

Доставлено:

<output>
    <MESSAGES>
        <MESSAGE SMS_ID="11003">
            <SMS_STATUS>2000000</SMS_STATUS>
            <SMS_CLOSE_TIME>14.08.25 09:24:05</SMS_CLOSE_TIME>
            <sent_dt>140825092405+</sent_dt>
            <SMSSTC_CODE>delivered</SMSSTC_CODE>
            <SMS_SENT>1</SMS_SENT>
        </MESSAGE>
    </MESSAGES>
</output>

Проверка баланса

Запрос:

POST https://api.unibell.ru/smw/aisms?action=balance&user=user123&pass=pass123

Параметры могут передаваться в формате x-www-form-urlencoded:

Пример запросов с использованием CURL:

curl --location --request POST 'https://api.unibell.ru/smw/aisms?user=user123&pass=pass123&action=balance'

curl --location 'https://api.unibell.ru/smw/aisms' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'user=login' \
--data-urlencode 'pass=password' \
--data-urlencode 'action=balance'

Параметр	Тип	Описание
user	string	Логин, указанный при HTTP-подключении с авторизацией типа «Basic Auth»
pass	string	Пароль, указанный при HTTP-подключении с авторизацией типа «Basic Auth»
action	string	Для запроса баланса значение должно быть balance

Тело ответа:

<output>
    <balances>
        <total_balance>1234.5678</total_balance>
    </balances>
</output>

На этой странице