Описание HTTP API Itsms

Описание HTTP API Itsms:

Все параметры передаются методом GET.

Адрес для запросов:

http://itsms/api

Обязательные параметры:

email={EMAIL}

password={PASSWORD}

command={COMMAND}

{EMAIL} - Ваш e-mail на сайтe

{PASSWORD} - Ваш пароль на сайте

{COMMAND} - одна из ниже перечисленных команд.

send: - отправка одного сообщения

Входящие параметры:

Параметр	Обязательно	Описание
from	Да	Имя (телефон) отправителя. Латинские символы или числа до 11 символов, а так же точка, тире, подчеркивание.
to	Да	Телефон получателя в международном формате. Для Украины можно в локальном.
message	Да	Текст сообщения в кодировке UTF8

Результат работы в случае успешной отправки:

SMS sent: {MESSAGE_COUNT}. Status id: {MESSAGE_ID}.

{MESSAGE_COUNT} – количество отправленных смс.

{MESSAGE_ID} – уникальное id отправленного смс. По нему можно отследить статус доставки.

Результат работы в случае ошибок:

Error: {ERROR_TEXT}.

Пример строки запроса:

http://itsms/api?email=EMAIL&password=PASS&command=send&from=test&to=&message=test

receive: - получение текущего статуса сообщения.

Входящие параметры:

Параметр	Описание
id	Номер сообщения, выданный при успешной отправке командой «send»

Результат работы в случае успешного выполнения:

Sending status: {STATUS_TEXT}. Time: {STATUS_TIME}

{STATUS_TEXT} - текст статуса сообщения на русском языке, в кодировке UTF8.

{STATUS_ TIME } – время изменения последнего статуса.

Возможные статусы:

- Ожидает

- Отправляется

- Отправлено

- Доставлено

- Нет на связи

- Частично доставлено

- Сбой сети при доставке SMS

- Ошибка в номере

- Номер не обслуживается

Пример строки запроса:

http://itsms.com.ua/api?email=EMAIL&password=PASS&command=receive&id=

balance: - проверка баланса системы.

Входящие параметры: нет.

Результат работы в случае успешного выполнения:

Balance: {AMOUNT} СМС.

{AMOUNT} – состояние баланса, к-во СМС.

Пример строки запроса:

http://itsms/api?email=EMAIL&password=PASS&command=balance