Описание API

8 *****@***ru www.fabrika-r.ru

Описание API

Для работы по https, посылайте запрос на домен *****

Под-домен api. ***** не принимает https.

Кириллицу следует передавать в формате url encoded.

1. Передача одного sms сообщения

GET запрос на сервер, вида:

http://api. *****/api. php? user=test&pass=test&from=test&text=text&to=

Параметр	Статус	Описание
user	Обязательно	Логин в системе
pass	Обязательно	Пароль
to	Обязательно	Номер телефона получателя, в формате
text	Обязательно	Текст сообщения, в UTF-8 кодировке
from	Обязательно	Подпись отправителя (латиница до 11 или цифры до 14 символов)
date	Не обязательно	Дата для отложенной отправки сообщения, Unix time (количество секунд с 1 января 1970 года) Если не указано, отправляется сразу после запроса

При успешной отправке, в ответ сервис должен вернуть text/xml ответ вида: <response> <status>accepted</status> <sms id_sms="">send</sms> </response>

При ошибке: <response> <status>error</status> <message>текст ошибки</message> </response>

Расшифровка ошибок:

Параметр	Описание
accepted	Сообщение принято сервисом
empty field. reject	Не все обязательные поля заполнены
incorrect user or password. reject	Ошибка авторизации
no credits	Недостаточно sms на балансе
incorrect destination adress. reject	Неверно задан номер телефона (формат )
incorrect date. reject	Неправильный формат даты (только unix time)
incorrect sender name. reject	Неверная (неразрешенная) подпись отправителя

2. Передача множества sms сообщений

Если номеров несколько – они должны быть перечислены через запятую, без пробелов.

http://api. *****/api. php? user=test&pass=test&from=test&text=text&to=, ,,

Рекомендуем не делать отправку более 80 сообщений за один запрос.

Это оптимальное значение.

3. Проверка состояния счета

GET запрос на сервер, вида: http://api. *****/api. php? a=balance&user=test&pass=test

Параметр	Статус	Описание
user	Обязательно	Логин в системе
pass	Обязательно	Пароль

При успешной авторизации, в ответ сервис должен вернуть text/xml ответ вида:

<response>

<balance>38</balance>

</response>

где цифра – это количество SMS, доступных на балансе.

4. Запрос на получение списка баз

GET запрос на сервер, вида: http://api. *****/api. php? a=bases&user=test&pass=test

5. Запрос на получение списка абонентов указанной базы

http://api. *****/api. php? a=list_phones&user=test&pass=test&baseid=74275&pageid=1

Параметр	Статус	Описание
user	Обязательно	Логин в системе
pass	Обязательно	Пароль
baseid	Обязательно	ID базы. Посмотреть можно в личном кабинете или через API, запросив список баз.
pageid	Обязательно	Номер страницы

Весь список номеров базы делится на страницы. Запросить

целиком базу нельзя, во избежание перегрузки системы запросом, т. к. базы могут быть

достаточно большие, сотни тысяч записей. Можно лишь запросить отдельную страницу.

Нумерация начинается с 1.

6. Запрос на добавление или редактирование абонентов базы

http://api. *****/api. php? a=phones&user=test&pass=test&baseid=999&phone=

Параметр	Статус	Описание
user	Обязательно	Логин в системе
pass	Обязательно	Пароль
baseid	Обязательно	Номер базы в системе.
phone	Обязательно	Номер телефона абонента. Если абонент с таким номером уже существует, то он будет отредактирован.
region	Не обязательно	Регион. Если не задано, определяется автоматически.
operator	Не обязательно	Оператор. Если не задано, определяется автоматически.
name	Не обязательно	Имя абонента
surname	Не обязательно	Фамилия абонента
patronymic	Не обязательно	Отчество абонента
date_birth	Не обязательно	Дата рождения
male	Не обязательно	Пол. «m» - мужской, «f» - женский.
addition_1	Не обязательно	Первое дополнительное поле.
addition_2	Не обязательно	Второе дополнительное поле.

7. Запросы для работы со стоп-листом абонентов.

На номера, добавленные в стоп-лист, не будет происходить рассылка, даже если сервер получает запрос на отправку sms на этот номер.

7.1 Добавить в стоп-лист

http://api. *****/api. php? a=addstop&user=test&pass=test&phones=

или номера через запятую

7.2 Удалить из стоп-листа

http://api. *****/api. php? a=delstop&user=test&pass=test&phones=

или номера через запятую

По всем вопросам пишите на *****@***ru