Установи программу
Войдите в систему
Рассылайте СМС

Свободная интеграция

__________________________________________________________________________________________________

 

Нашими специалистами разработанно удобное руководство для программистов, спомощью которого можно настроить интеграцию нашей программы с ситемами 1С, HTTP/XML, SMPP 3.4, SDK Email2SMS. Более подробную информацию Вы можете получить у наших менеджеров по телефону.


API от SMS Start

__________________________________________________________________________________________________


Передача сообщения

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

http://api_login: Этот e-mail адрес защищен от спам-ботов, для его просмотра у Вас должен быть включен Javascript /send/?phone=%2B71234567890&text=test

 


api_login, api_password — данные для авторизации

phone — номер телефона, в формате +71234567890

text — текст сообщения, в UTF-8 кодировке

wapurl — в случае, если вы хотите передать wap-push сообщение (например wap.yousite.ru)

sender — подпись отправителя

scheduleTime — дата для отложенной отправки сообщения, в UTC формате (2009-01-01T12:30:01+00:00)

statusQueueName — название очереди статусов отправленных сообщений, в случае, если вы хотите использовать очередь статусов отправленных сообщений. От 3 до 16 символов, буквы и цифры (например myQueue1)

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

A132571BC=accepted


где до знака "=" сервис выдает идентификатор сообщения, а после знака "=" ответ сервиса о статусе сообщения:

accepted — сообщение принято сервисом

Другие варианты ответа сервера:

invalid mobile phone — неверно задан номер тефона (формат 71234567890)

text is empty — отсутствует текст

sender address invalid — указано неверно заданное обратное слово

wapurl invalid — указана неверно заданная ссылка

invalid schedule time format — неверный формат даты отложенной отправки сообщения

invalid status queue name — неверное название очереди статусов сообщений

not enough credits — баланс пуст (проверьте баланс)

 

Проверка состояния отправленного сообщения

__________________________________________________________________________________________________

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

http://api_login: Этот e-mail адрес защищен от спам-ботов, для его просмотра у Вас должен быть включен Javascript /status/?id=A132571BC

 

Возможно использование SSL соединения.

api_login, api_password — данные для авторизации

id — идентификатор сообщения, который вернул сервис при отправке сообщения

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

A132571BC=delivered


где до знака "=" сервис выдает идентификатор сообщения, а после знака "=" ответ сервиса о статусе сообщения:

queued — сообщение находится в очереди

delivered — сообщение доставлено

delivery error — ошибка доставки SMS (абонент в течении времени доставки находился вне зоны действия сети или номер абонента заблокирован)

smsc submit — сообщение доставлено в SMSC

smsc reject — сообщение отвергнуто SMSC (номер заблокирован или не существует)

incorrect id — неверный идентификатор сообщения

 

Проверка очереди статусов отправленных сообщений

__________________________________________________________________________________________________

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

http://api_login: Этот e-mail адрес защищен от спам-ботов, для его просмотра у Вас должен быть включен Javascript /statusQueue/?statusQueueName=myQueue1&limit=5


Возможно использование SSL соединения.

api_login, api_password — данные для авторизации

statusQueueName — название очереди статусов сообщений. Название очереди задается при передаче сообщения

limit — количество запрашиваемых статусов из очереди

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

A132571BC=smsc submit
A132571BC=delivered
A13257316=smsc submit
A1325753A=delivery error
A13257316=delivered


где сервис возвращает по одному статусу в каждой строке. Подробнее о статусах.

Другие варианты ответа сервера:

queue is empty — очередь пуста

absent status queue name — отсутствует название очереди статусов сообщений

invalid status queue name — неверное название очереди статусов сообщений

 

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

__________________________________________________________________________________________________

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

http://api_login: Этот e-mail адрес защищен от спам-ботов, для его просмотра у Вас должен быть включен Javascript /credits/


Возможно использование SSL соединения.

api_login, api_password — данные для авторизации

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

credits=12345

где цифра, это количество доступных SMS на балансе (без учета возможного кредита)

 

Список доступных подписей отправителя

__________________________________________________________________________________________________

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

http://api_login: Этот e-mail адрес защищен от спам-ботов, для его просмотра у Вас должен быть включен Javascript /senders/


Возможно использование SSL соединения.

api_login, api_password — данные для авторизации

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

Sender_one
Sender_two
Sender_three

где выводится список доступных подписей по одной в каждой строке.