Общие принципы отправки.

На определенный адрес сервера отправляются XMLдокументы (описание XMLдокументов, их назначение и адреса сервера приведены ниже). При этом используется POSTметод.

Заголовки отправляемых данных должны содержать:

Content-type: text/xml; charset=utf-8

Кодировка XMLдокументов UTF-8

При этом передаваемый XMLдокумент не должен содержать переводов строки.

Переводы строк в самих данных должны быть заменены на “/n”.

Пример передачи XMLдокумента на php:

$src = '<?xml version="1.0" encoding="utf-8"?><request><security><login value="логин" /><password value="пароль" /></security></request>'; // XML-документ

$href = 'http://server/script.php'; // адрес сервера

$res = '';

$ch = curl_init();

curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-type: text/xml; charset=utf-8'));

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

curl_setopt($ch, CURLOPT_CRLF, true);

curl_setopt($ch, CURLOPT_POST, true);

curl_setopt($ch, CURLOPT_POSTFIELDS, $src);

curl_setopt($ch, CURLOPT_URL, $href);

$result = curl_exec($ch);

$res = $result;

curl_close($ch);

echo $res;

ОтправкаSMS, Flash SMS, WAP-Push.

Адрес сервера:

http://my.smpp-server.ru/xml/

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

<sender_viber>Отправитель Viber сообщения</sender_viber>

<text_viber>Текст сообщения</text_viber>

<button_viber>Текст кнопки</button_viber>

<action_viber>Ссылка для кнопки</action_viber>

<image_viber>Адрес картинки</image_viber>

<sender>Отправитель 1</sender>

<text>Текст сообщения 1</text>

<url>Адрес для WAP Push или vCard</url>

<name>Имядля vCard</name>

<email>E-mail vCard</email>

<position>Должность vCard</position>

<organization>Организация vCard</organization>

<additional>Дополнительнаяинформация vCard</additional>

...

</message>

<sender>Отправитель 2</sender>

<text>Текстсообщения 2</text>

...

</message>

...

</security>

</request>

Где,

type_send_1 – тип отправляемого сообщения viber или sms

type_send_2 – тип досылаемого сообщения, в случае если отправляемое сообщение не будет доставлено viber или sms.

type – тип SMS сообщения:

flashsms – flash SMS

silence – невидимые SMS (для проверки статуса абонента)

sms – обычнаяSMS

wappush – WAP-Push

vcard – визитнаякарточка (vCard)

sender_viber – отправитель Viber сообщения

text_viber - текст Viber сообщения

button_viber - текст кнопки Viber сообщения

action_viber - ссылка для кнопки Viber сообщения

image_viber - адрес картинки для Viber сообщения

sender – отправитель SMS. Именно это значение будет выводиться на телефоне абонента в поле от кого SMS.

phone – номер абонента, которому адресована SMS.

loginvalue -ваш логин в системе

passwordvalue - ваш пароль в системе

number_sms - номер сообщения в пределах отправляемого XML документа.

client_id_sms - число. Необязательный параметр, позволяет избежать повторной отправки. Если раннее с этого аккаунта уже было отправлено SMS с таким номером, то повторная отправка не производится, а возвращается номер ранее отправленного SMS.

time_send – дата и время отправки в формате:

YYYY-MM-DD HH:MM

где, YYYY-год, MM-месяц, DD-день,HH-часы, MM-минуты.

Если не задано, то SMSотправляется сразу же.

validity_period – дата и время, после которых не будут делаться попытки доставить SMS в формате:

YYYY-MM-DD HH:MM

где, YYYY-год, MM-месяц, DD-день,HH-часы, MM-минуты.

Если не задано, то SMS имеет максимальный срок жизни.

validity_period_viber – дата и время, после которых не будут делаться попытки доставить Viber сообщение в формате:

YYYY-MM-DD HH:MM

где, YYYY-год, MM-месяц, DD-день,HH-часы, MM-минуты.

Если не задано, то Viber сообщение имеет максимальный срок жизни (один день).

Далее поля выбираются в зависимости от типа отправляемого SMS (type):

text – текст обычного SMSили описание WAPссылки.

url–ссылка для WAP Push или vCard

name - имядляvCard

cell – номер телефона для vCard

work - номер рабочего телефона для vCard

fax - номер факса для vCard

email - e-mailдля vCard

position – должностьконтактадля vCard

organization - организациядля vCard

post_office_box - абонентскийящикдля vCard

street – улицадля vCard

city – городдля vCard

region–областьдля vCard

postal_code–индексдля vCard

country - страна для vCard

additional - дополнительнаяинформация для vCard

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Ваш аккаунт заблокирован

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<information number_sms="1" id_sms="ID SMS всистемедляпроверкистатуса" parts="2">Статус/сообщениеобошибке</information>

<information number_sms="2" id_sms="ID SMS всистемедляпроверкистатуса" parts="2">Статус/сообщениеобошибке</information>

<information number_sms="3" id_sms="ID SMS всистемедляпроверкистатуса" parts="2">Статус/сообщениеобошибке</information>

…

</response>

Где,

number_sms - номер сообщения указанный при отправке XML документа.

id_sms - номер SMSсообщения. Используется для проверки статуса SMS. Если в процессе отправки SMS произошла ошибка, то id_sms не передается.

parts - количество частей SMS.

information – статус сообщения («send»), если SMSбыла отправлена. Или сообщение об ошибке, если в процессе отправки SMSпроизошла ошибка:

У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером.

Закончились SMS.

Аккаунт заблокирован.

Укажите номер телефона.

Номер телефона присутствует в стоп-листе.

Данное направление закрыто для вас.

Данное направление закрыто.

Текст SMS отклонен модератором.

Нет отправителя.

10. Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых.

11. Номер телефона должен быть меньше 15 символов.

12. Нет текста сообщения.

13. Нет ссылки.

14. Укажите название контакта и хотя бы один параметр для визитной карточки.

15. Такого отправителя нет.

16. Отправитель не прошел модерацию.

Запрос статуса SMSсообщения (первый способ).

Адрес сервера:

http://my.smpp-server.ru/xml/state.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

<get_state>

<id_sms>IDSMS в системе для проверки статуса</id_sms>

</get_state>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - ваш пароль в системе

id_sms - номер SMSсообщения, полученный в ответном XML-документа в процессе отправки SMSсообщения.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" sms="Статус">Статус</state>

<state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" sms="Статус" viber="Статус">Статус</state>

<state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" viber="Статус">Статус</state>

</response>

Где,

id_sms - номер SMSсообщения, полученный в ответном XML-документа в процессе отправки SMSсообщения.

time – время изменнеия статуса.

sms, viber – статус сообщения. Название поля зависит от типа отправляемого и досылаемого сообщения.

state – последний статус сообщения:

«send» - статус сообщения не получен. В этом случае передается пустой time (time="").

«not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).

«expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный статус (не меняется со временем).

«deliver» - сообщение доставлено.

«read» - сообщение прочитано. Конечный статус (не меняется со временем).

«partly_deliver» - сообщение было отправлено, но статус так и не был получен.

Получение статуса SMS сообщения (второй способ).

При использовании данного способа необходимо сообщить менеджеру адрес вашего сервера, который будет принимать статусы SMS.

XML-документ будет отправлен POSTметодом.

К примеру, в phpXML-документ будет доступен через переменную $GLOBALS['HTTP_RAW_POST_DATA']

Система отправляет XML-документ серверу клиента следующего содержания:

<?xml version="1.0" encoding="utf-8"?><request>

<state id_sms="ID SMS в системе для проверки статуса" time="2011-01-01 12:57:46">Статус</state>

</request>

Где,

id_sms - номер SMSсообщения, полученный в ответном XML-документа в процессе отправки SMSсообщения.

time – время изменнеия статуса.

state – статус сообщения:

«send» - статус сообщения не получен. В этом случае передается пустой time (time="").

«not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).

«expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный статус (не меняется со временем).

«deliver» - сообщение доставлено.

«read» - сообщение прочитано. Конечный статус (не меняется со временем).

«partly_deliver» - сообщение было отправлено, но статус так и не был получен.

В ответ сервер клиента должен вернутьXML-документ следующего содержания:

<?xml version="1.0" encoding="utf-8" ?>

<id_sms>3234</id_sms>

<id_sms>3235</id_sms>

</response>

Где,

id_sms - номер SMSсообщения, полученный в ответном XML-документа в процессе отправки SMSсообщения.

Если сервер клиента не передаст id_sms, то статус будет считаться не полученным клиентом. При этому будет сделано 5 попыток доставить статус.

Запрос проверки баланса.

Адрес сервера:

http://my.smpp-server.ru/xml/balance.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - ваш пароль в системе

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

</response>

Где,

money – остаток средств.

area–направление в котором может быть отправлено данное количество SMS.

sms – количество доступных SMSсообщений для данного направления.

При этом количество SMSне может быть суммировано по разным направлениям. При отправке смс в одном направлении уменьшается количество доступных SMSсообщений в во всех других направления в соответствии с их стоимостью.

Пример

У вас на балансе 10 y.e.

Стоимость SMSсообщения отправленного в Россию составляет 1y.e.

Стоимость SMSсообщения отправленного в Украину составляет 2y.e.

При этом вам вернется XMLдокумент следующего содержания.

<?xml version="1.0" encoding="utf-8" ?>

</response>

Если вы отправите две смс в Россию, то XML-документ изменится следующим образом:

<?xml version="1.0" encoding="utf-8" ?>

</response>

Запрос на получения списка отправителей.

Адрес сервера:

http://my.smpp-server.ru/xml/originator.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - ваш пароль в системе

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<any_originator>FALSE</any_originator>

<list_originator>

<originator MCC="МСС" MNC="МНС" template="шаблон" comment="комментарий" history="комментарий" operator="оператор" state="rejected">Отправитель</originator>

</list_originator>

</response>

Где,

any_originator- TRUE/FALSE - может ли клиент отправлять от любого отправителя или только от заранее одобренных. Если TRUE, то клиент может использовать любого отправителя. При этом список отправителей не возвращается. FALSE – можно использовать только отправителей со статусом «ompleted».

state - статус отправителя:

'order' – оформляется

'completed' - готов к использованию

'rejected' – отклонен

MCC – мобильный код страны

MNC - мобильный код оператора

template – наименование шаблона

comment - комментарий клиента

history - комментарий менеджера

operator – используемый оператор

Запрос на добавление отправителей.

Адрес сервера:

http://my.smpp-server.ru/xml/add_originator.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

<originator INN="ИНН" KPP="КПП" OGRN="ОГРН" name_counterparty="имя контрагента" template="текст шаблона" comment="комментарий" >Отправитель</originator>

…

…

</request>

Где,

login value – ваш логин в системе

password value - ваш пароль в системе

originator – отправитель, которого нужно добавить

operator MCC – мобильный код страны

operator MNC - мобильный код оператора

file href – ссылка на загружаемый файл

file id – id загружаемого файла

originator INN – ИНН организации

originator KPP – КПП организации

originator OGRN - ОГРН организации

originator name_counterparty – имя контрагента

originator template - текст шаблона

comment – комментарий.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

10. Неправильный формат XML документа

11. Неправильный логин или пароль

12. POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<originator id_originator="">Отправитель поставлен в очередь на регистрацию.</ originator>

</response>

Где,

originator – результат добавления отправителя. Может содержать следующие значения:

Отправитель добавлен.

Отправитель поставлен в очередь на регистрацию.

Отправитель может состоять только из 11-ти латинских символов, цифр, пробелов и знаков "\'?><,.-_=+/"!@#$%^&*() " или 15-ти цифр.

Запрос входящих SMS.

Адрес сервера:

http://my.smpp-server.ru/xml/incoming.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - ваш пароль в системе

timestart – время (не включительно), с которого запрашиваются входящие SMS.

timeend - время (не включительно), по которое запрашиваются входящие SMS. Не обязательный параметр. Если не задан, то будут возвращены все смс.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

13. Неправильный формат XML документа

14. Неправильный логин или пароль

15. POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<sms id_sms="1234" date_receive="2012-01-31 12:55:55" originator="79612242243" prefix="IGRA" phone="79611111111">ТекстСМС.</sms>

…

</response>

Где,

id_sms–Уникальный номер, состоящий только из цифр.

date_receive–Дата и время получения SMS.

originator – номер телефона абонента, отправившего SMS.

prefix – префикс. Начальная часть текста SMS, по которой было определено, что эта SMSпринадлежит именно этому клиенту. (Используется если один и тот же номер используется разными клиентами.)

phone – номер телефона, на который бала отправлена SMS.

sms – текст смс

Запрос на получение информации по номеру телефона.

Адрес сервера:

http://my.smpp-server.ru/xml/def.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</phones>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - ваш пароль в системе

phone– Номер телефона.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

…

</response>

Где,

operator – Оператор.

region – Регион.

time_zone – Смещение времени в часах относительно времени в Москве.

phone – номер телефона.

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

Адрес сервера:

http://my.smpp-server.ru/xml/list_bases.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - ваш пароль в системе

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<base id_base="1234" name_base="Базаглавногоофиса" time_birth="12:48" local_time_birth="yes" day_before="1"originator_birth="fitnes" on_birth="yes">Поздравляем!</base>

<base id_base="1235" name_base="БазаМосковскогоофиса" time_birth="12:48" local_time_birth="yes" day_before="1"originator_birth="fitnes" on_birth="yes">Поздравляем!</base>

…

</response>

Где,

id_base – уникальный номер базы в системе.

name_base – название базы.

time_birth – Время поздравления.

local_time_birth – Считать время поздравления относительно местноговремени абонента(yes) или относительно времени системы (no).

day_before– За сколько дней до дня рождения поздравлять.

originator_birth – Отправитель поздравления.

on_birth –Включены ли поздравления yes – включены, no - выключены.

base –Текст поздравления.

Запрос на изменение параметров/добавление/удаление баз.

Адрес сервера:

http://my.smpp-server.ru/xml/bases.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

<bases>

<base id_base="1234" name_base="Базаглавногоофиса" time_birth="12:48" local_time_birth="yes" day_before="1" originator_birth="fitnes" on_birth="yes">Поздравляем!</base>

<base number_base="1" name_base="БазаМосковскогоофиса" time_birth="12:48" local_time_birth="yes" day_before="1" originator_birth="fitnes" on_birth="yes">Поздравляем!</base>

</bases>

<delete_bases>

…

</delete_bases>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - вашпарольвсистеме

id_base – уникальный номер базы в системе. Если не указан произойдет добавление базы. При этом нужно указать параметр number_base.

number_base – Номер базы в XMLзапросе. Указывается только при создании новой базы. Используется для сопоставления IDдобавленных баз (если их было не сколько в запросе).

name_base – название базы.

time_birth – Время поздравления.

local_time_birth – Считать время поздравления относительно местноговремени абонента(yes) или относительно времени системы (no).

originator_birth – Отправитель поздравления.

on_birth –Включены ли поздравления yes – включены, no - выключены.

base –Текст поздравления.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<base number_base=”1” id_base=”1235”>insert</ base>

<base id_base=”1235”>delete</ base>

<base id_base=”1235”>not_found</ base>

…

</response>

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

Адрес сервера:

http://my.smpp-server.ru/xml/list_phones.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</request>

Где,

login value – ваш логин всистеме

password value - ваш пароль в системе

baseid_base – Номер базы в системе.

basepage – Номер страницы. Весь список номеров базы делится на страницы. Запросить целиком базу нельзя. Можно лишь запросить отдельную страницу. Нумерация начинается с единички.

last_update – минимальная дата и время регистрации (или последнего изменения) данных абонента, которых Вам нужно запросить.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

Базы с таким номером не существует

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

…

</phones>

</response>

Где,

page – номерстраницы

num_pages – всегостраниц

phone – номер телефона абонента

region – регион

operator – оператор

name –Имя абонента

surname – Фамилия абонента

patronymic –Отчество абонента

date_birth –Дата рождения

male –Пол. «m» - мужской, «f»- женский

addition_1 –Первое дополнительное поле.

addition_2 –Второе дополнительное поле.

last_update – дата и время регистрации (или последнего изменения) данных абонента.

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

Адрес сервера:

http://my.smpp-server.ru/xml/phones.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

…

….

</base>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - вашпарольвсистеме

baseid_base – Номер базы в системе.

phone – номер телефона абонента. Если абонент с таким номером уже существует, то он будет отредактирован.

region – регион. Необязательное поле. Если не задано определяется автоматически.

operator – оператор. Необязательное поле. Если не задано определяется автоматически.

name – Имя абонента. Необязательное поле.

surname – Фамилия абонента. Необязательное поле.

patronymic –Отчество абонента. Необязательное поле.

date_birth –Дата рождения. Необязательное поле.

male –Пол. «мужской» или «женский». Необязательное поле.

addition_1 –Первое дополнительное поле. Необязательное поле.

addition_2 –Второе дополнительное поле. Необязательное поле.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

Базы с таким номером не существует

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<baseid_base="1234">

<phone phone="79612242243" number_phone="1"/>insert</phone>

<phone phone="79612242243" number_phone="5"/>delete</phone>

<phone phone="79612242244" number_phone="6" />not_found</phone>

</base>

…

</response>

Где,

Запрос на получение списка номеров из СТОП-листа.

Адрес сервера:

http://my.smpp-server.ru/xml/list_stop.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - ваш пароль в системе

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

…

</response>

Где,

phone –Номер телефона из СТОП-листа.

Запрос на добавление/удаление абонентов в СТОП-лист.

Адрес сервера:

http://my.smpp-server.ru/xml/stop.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

<add_stop>

…

</add_stop>

<delete_stop>

…

</delete_stop>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - вашпарольвсистеме

add_stopphone – номертелефонаабонента, которого нужно добавить в СТОП-лист.

delete_stopphone – номертелефонаабонента, которого нужно удалить из СТОП-листа.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<phone phone="79612242243">delete</phone>

<phone phone="79612242245">not_found</phone>

…

</response>

Где,

Запрос на получение списка запланированных SMS.

Адрес сервера:

http://my.smpp-server.ru/xml/list_scheduled.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - ваш пароль в системе

scheduledpage – Номер страницы. Весь список запланированных SMS делится на страницы. Запросить список целиком нельзя. Можно лишь запросить отдельную страницу. Нумерация начинается с единички.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

…

</phones>

</response>

Где,

page – номерстраницы

num_pages – всегостраниц

id_sms – номерSMS. Используется для удаления запланированной SMS.

time_put_turn– Время добавления в планировщик.

operator – отправитель SMS. Именно это значение будет выводиться на телефоне абонента в поле от кого SMS.

phone – номер абонента, которому адресована SMS.

type – тип отправляемого SMSсообщения:

sms – обычнаяSMS

flashsms – flash SMS

wappush – WAP-Push

vcard – визитнаякарточка (vCard)

text_sms–Текст SMS-сообщения.

count_sms–Количество частей SMS-сообщения.

name_delivery–Название рассылки.

time_send – дата и время отправки в формате:

YYYY-MM-DDHH:MM

где, YYYY-год, MM-месяц, DD-день,HH-часы, MM-минуты.

validity_period – дата и время, после которых не будут делаться попытки доставить SMS в формате:

YYYY-MM-DDHH:MM:SS

где, YYYY-год, MM-месяц, DD-день,HH-часы, MM-минуты, SS-секунды.

Запрос на удаление запланированной SMS.

Адрес сервера:

http://my.smpp-server.ru/xml/scheduled.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

<delete_schedule>

…

</delete_schedule>

</request>

Где,

loginvalue - вашлогинвсистеме

passwordvalue - вашпарольвсистеме

delete_scheduleid_sms – номерзапланированной SMS, которую нужно удалить. Можно получить при запросе списка запланированных SMS.

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

<scheduled id_sms="1234">delete</scheduled>

<scheduled id_sms="1235">not_found</scheduled>

…

</response>

Где,

Запрос на получение времени изменения чего либо.

Адрес сервера:

http://my.smpp-server.ru/xml/check_change.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</request>

Где,

login value - вашлогинвсистеме

password value - ваш пароль в системе

obgect – base – базы данных, stop-стоп лист

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текстошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

Базы с таким номером не существует

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

</response>

Где,

time_update– время последнего изменения объекта

Запрос проверки времени:

Адрес сервера:

http://my.smpp-server.ru/xml/time.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>

</security>

</request>

Где,

login value – ваш логин в системе

password value - ваш пароль в системе

В ответ может быть выдан один из следующих XML-документов:

В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>

<error>текст ошибки</error>

</response>

error - текст ошибки может принимать следующие значения:

Неправильный формат XML документа

Неправильный логин или пароль

POST данные отсутствуют

В случае получения правильного XML-документа:

<?xml version="1.0" encoding="utf-8" ?>

</response>

Где,

time – локальное время пользователя.

При этом время рассчитывается как время на сервере минус разница часовых поясов пользователя и сервера.

Пример

Сервер находиться в Москве и серверное время у него московское, в момент запроса оно составляло: 15:34:27.

А пользователь числился в Новосибирске и разница часовых поясов (между сервером и пользователём) у него равнялось +3.

При этом вам вернется XMLдокумент следующего содержания.

<?xml version="1.0" encoding="utf-8"?>

</response>

Запрос на загрузку файлов:

Адрес сервера:

http://my.smpp-server.ru/xml/file.php

Для загрузки файла на сервер необходимо отправить POST данные содержащие переменные login, password, file. В ответ будет выдан id сохраненного файла, который в дальнейшем вы можете использовать в xml-запросах.

Пример php кода для загрузки файла:

$href = "http://my.smpp-server.ru/xml/file.php";

$tmpfname = "имя";

$requist['login'] = "логин";

$requist['passsword'] = "пароль";

if(PHP_VERSION_ID < 56000)

$requist['file'] = '@' . $tmpfname;

else

$requist['file'] = new CurlFile($tmpfname, 'image/jpg');

$res = '';

$in = '';

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $href);

curl_setopt($ch, CURLOPT_POST, TRUE);

curl_setopt($ch, CURLOPT_HEADER, FALSE);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30);

curl_setopt($ch, CURLOPT_POSTFIELDS, $requist);

$result = curl_exec($ch);

curl_close($ch);

echo $result;

Где,

$tmpfname – путь до файла отгрузки (Пример: C:\Program Files\file\test.jpg)

$requist['login'] – ваш логин в системе

$requist['passsword'] – ваш пароль в системе.

Ответ:

id – id вашего сохраненного файла.

Возможные ошибки:

Не удалось скопировать файл!

Неверный логин или пароль!

Page tree

Спецификация XML-шлюза

Общие принципы отправки.

Пример передачи XMLдокумента на php:

ОтправкаSMS, Flash SMS, WAP-Push.

Запрос статуса SMSсообщения (первый способ).

Получение статуса SMS сообщения (второй способ).

Запрос проверки баланса.

Запрос на получения списка отправителей.

Запрос на добавление отправителей.

Запрос входящих SMS.

Запрос на получение информации по номеру телефона.

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

Запрос на изменение параметров/добавление/удаление баз.

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

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

Запрос на получение списка номеров из СТОП-листа.

Запрос на добавление/удаление абонентов в СТОП-лист.

Запрос на получение списка запланированных SMS.

Запрос на удаление запланированной SMS.

Запрос на получение времени изменения чего либо.

Запрос проверки времени:

Запрос на загрузку файлов: