XML-ПРОТОКОЛ
Введение
Данный протокол основан на передаче POST-запросом сформированной определенным образом XML
(вместо привычных var1=value1&var2=value2) на наш сервер.
К примеру, на PHP такой запрос можно выполнить подобным образом:
$xml = "<?xml version='1.0' encoding='UTF-8'?> <data> <login>LOGIN</login> <password>PASSWORD</password> <action>send</action> <text>TEXT</text> <to number='89010003333'></to> </data>"; $address = "https://lcab.smsint.ru/API/XML/send.php"; $ch = curl_init($address); curl_setopt($ch, CURLOPT_URL, $address); curl_setopt($ch, CURLOPT_FAILONERROR, 1); curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); curl_setopt($ch, CURLOPT_TIMEOUT, 10); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $xml); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); curl_setopt($ch, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4); $result = curl_exec($ch); echo $result; curl_close($ch);
А вот так можно отправлять запросы, используя C# в качестве языка программирования:
/* action = send|balance|report|cancel */ public String request(string action, string xml) { WebResponse result = null; WebRequest req = null; Stream newStream = null; Stream ReceiveStream = null; StreamReader sr = null; string strOut = ""; try { req = WebRequest.Create("https://lcab.smsint.ru/API/XML/" + action + ".php"); req.Method = "POST"; req.Timeout = 120000; req.ContentType = "application/x-www-form-urlencoded"; byte[] SomeBytes = null; SomeBytes = UTF8Encoding.UTF8.GetBytes(xml); req.ContentLength = SomeBytes.Length; newStream = req.GetRequestStream(); newStream.Write(SomeBytes, 0, SomeBytes.Length); newStream.Close(); result = req.GetResponse(); ReceiveStream = result.GetResponseStream(); Encoding encode = Encoding.UTF8; sr = new StreamReader(ReceiveStream, encode); Char[] read = new Char[256]; int count = sr.Read(read, 0, 256); while (count > 0) { String str = new String(read, 0, count); strOut += str; count = sr.Read(read, 0, 256); } } catch (Exception ex) { //MessageBox.Show("Error: " + ex.Message); } finally { if (newStream != null) newStream.Close(); if (ReceiveStream != null) ReceiveStream.Close(); if (sr != null) sr.Close(); if (result != null) result.Close(); } return strOut; }
Отправка СМС
Для отправки СМС, необходимо передать методом POST на адрес https://lcab.smsint.ru/API/XML/send.php следующую XML:
<?xml version='1.0' encoding='UTF-8'?> <data> <login>LOGIN</login> <password>PASSWORD</password> <action>send</action> <text>TEXT</text> <source>SOURCE</source> <to number='8-923-123-1234'></to> <to number='+7(901) 123-45 67'>Текст сообщения 1</to> <to number='9011234567'>Текст сообщения 2</to> <smsid>SMSID</smsid> <datetime>2016-12-31 23:59:59</datetime> <regionalTime>1 или 0</regionalTime> <vp>7200</vp> <stop>1 или 0</stop> <channel>ID</channel> <allowed_opsos>ID</allowed_opsos> <exclude_opsos>ID</exclude_opsos> </data>
Описание параметров
Параметр | Описание | Обязательный параметр |
---|---|---|
<login>LOGIN</login> | Вместо LOGIN необходимо подставить Ваш логин |
Да |
<password>PASSWORD</password> | Вместо PASSWORD необходимо подставить Ваш пароль |
Да |
<action>ACTION</action> | Действие ACTION может иметь только 2 значения: 1. check – проверка перед отправкой (делать не обязательно) 2. send – отправка СМС | Нет, по-умолчанию send |
<to number='NUMBER'></to> | Формат номера может любым, и содержать вспомогательные символы, например: • 79011234567 • +7(901) 123-45 67 • 8-901-123-4567 • 9011234567 Все эти примеры пройдут проверку на формат | Да |
<to number='NUMBER'> ALTER_TEXT </to> |
ALTER_TEXT – альтернативный текст, который будет отправлен на номер NUMBER | Нет, по умолчанию на номер NUMBER отправляется TEXT |
<to number='NUMBER' url='ALTER_URL'></to> | ALTER_URL – альтернативная ссылка для системного PUSH-сообщения | Нет |
<to number='NUM1'></to> <to number='NUM2'>T1</to> <to number='NUM3'>T2</to> |
Возможно использование нескольких параметров <to>. СМС будет отправлена на NUM1, NUM2 и NUM3. Причем на NUM2 и NUM3 будет отправлен текст T1 и T2 соответственно. На номер NUM1 будет отправлен текст TEXT | Нет, достаточно одного тега <to> |
<smsid>SMSID</smsid> | SMSID – идентификатор СМС (группы СМС). Данный параметр необходим для идентификации отправляемой СМС (группы СМС). Длина идентификатора должна быть не более 32 символов. | Нет, если этот параметр не передается, SMSID присваивается автоматически и отдается в ответе сервера. |
<datetime>DATETIME</datetime> | DATETIME – дата/время отправки. Время местное (согласно указанной информации о местоположении вашей компании при регистрации). DATETIME должен быть в формате MySQL. yyyy-mm-dd HH:MM:SS | Нет, если этот параметр не задан – СМС ставится в очередь немедленно |
<regionalTime>1</regionalTime> | Включение опции - отправка по местному времени абонента. | Нет. По-умолчанию опция выключена |
<source>SOURCE</source> | SOURCE – имя отправителя. | Нет, если не задано значение, то выбирается 1ое имя отправителя вашего логина |
<vp>VALIDATION_PERIOD</vp> | VALIDATION_PERIOD – время жизни СМС (указывается в секундах). Например, 2 часа = 2 * 3600 = 7200 | Нет. По умолчанию 24 часа. |
<flash>1 или 0</flash> | Если 1, то отправляется flash-смс, если 0 - то обычная. | Нет. Если не задано значение, то по-умолчанию 0 |
<wapPushUrl>http://yandex.ru</wapPushUrl> | Если значение задано, то отправляется сервисное Push-сообщение со ссылкой на сайт внутри | Нет. |
<stop>1 или 0</stop> | Если 1, то из списка абонентов удаляются те, что находятся в Стоп-листах. | Нет. Если не задано значение, то по-умолчанию 1 |
<channel>ID канала для отправки СМС</channel> |
0 - Прямой (гарантия, мультиподпись) 1 - Прямой (гарантия, без выбора подписи) 2 - Альтернативный (зарубеж) 3 - Альтернативный (Россия) |
Нет. |
<allowed_opsos>операторы</allowed_opsos> |
Перечисление операторов сотовой связи, которым можно отправлять это сообщение, через запятую, без пробелов. Например: "megafon,beeline" Остальным операторам сообщение отправляться не будет. |
Нет. |
<exclude_opsos>операторы</exclude_opsos> |
Перечисление операторов сотовой связи, которым запрещено отправлять это сообщение, через запятую, без пробелов. Например: "megafon,beeline" Остальным операторам сообщение будет отправлено. |
Нет. |
Ответ сервера:
<?xml version='1.0' encoding='UTF-8'?> <data> <code>CODE</code> <descr>DESCR</descr> <smsid>SMSID</smsid> <datetime>DATETIME</datetime> <action>ACTION</action> <allRecivers>ALL_RECIEVERS</allRecivers> <colSendAbonent>COL_SEND_ABONENT</colSendAbonent> <colNonSendAbonent> COL_NON_SEND_ABONENT </colNonSendAbonent> <priceOfSending>PRICE_OF_SENDING</priceOfSending> <colsmsOfSending>COL_SMS_OF_SENDING</colsmsOfSending> </data>>
Параметр | Описание |
---|---|
code | Код результата обработки (1 - успех, иначе - ошибка) |
descr | Описание результата обработки |
smsid | Идентификатор СМС (группы СМС). Данный параметр необходим для идентификации отправляемой СМС (группы СМС), в том числе, для получения по SMSID результатов отправки |
datetime | Дата/время отправки СМС (группы СМС) |
action | Выполненное действие (проверка или отправка: check или send) |
allRecivers | Всего получателей (абонентов). В эту цифру не входят номера, которые были отклонены из-за несоответствия формату, например, 74957271122 – не является мобильным телефоном, поэтому не попадет в ALL_RECIEVERS |
colSendAbonent | Кол-во получателей, которым СМС отправлены (могут быть отправлены). |
colNonSendAbonent | Кол-во получателей, которым СМС не отправлены (не могут быть отправлены). Причинами могут быть – нехватка средств на счету, пользователь расположен в глобальном Черном Списке, и тп. |
priceOfSending | Цена рассылки. |
colsmsOfSending | Общее кол-во смс к отправке. Соответственно двойная СМС, отправленная 3 абонентам даст значение COL_SMS_OF_SENDING=6. |
price | Стоимость одной СМС. |
Примеры использования
Задача 1. Требуется отправить следующий текст: «Добрый день, приглашаем Вас в наш салон», с подписью «Magazin» на 3 номера: +79019011234, +79029021234, +79039031234. Отправка должна произойти немедленно.
Решение:
На адрес https://lcab.smsint.ru/API/XML/send.php необходимо методом POST отправить следующую XML:
<?xml version='1.0' encoding='UTF-8'?> <data> <login>test</login> <password>123456</password> <action>send</action> <text>Добрый день, приглашаем Вас в наш салон</text> <source>Magazin</source> <to number='+79019011234'></to> <to number='7-902-902-12 34'></to> <to number='89039031234'></to> </data>
Обратите внимание, что поле номер может быть в любом формате, наша система сама приведет его в надлежащий вид.
Задача 2. Требуется отправить следующий текст: «Добрый день, приглашаем Вас в наш салон», с подписью «Magazin» на 3 номера: +79019011234, +79029021234, +79039031234. Отправка должна произойти 1 мая 2010 года в 12:00:00 (время Ваше местное – рассчитывается из информации, указанной при регистрации – Ваш город). На номер +79029021234 необходимо отправить уникальный текст: «Добрый день, приглашаем Вас в наш салон. Скидка по Вашей дисконтной карте – 5%»
Решение:
На адрес https://lcab.smsint.ru/API/XML/send.php необходимо методом POST отправить следующую XML:
<?xml version='1.0' encoding='UTF-8'?> <data> <login>test</login> <password>123456</password> <action>send</action> <text>Добрый день, приглашаем Вас в наш салон</text> <source>Magazin</source> <datetime>2010-05-01 12:00:00</datetime> <to number='+79019011234'></to> <to number='7-902-902-12 34'> Добрый день, приглашаем Вас в наш салон. Скидка по Вашей дисконтной карте – 5%</to> <to number='89039031234'></to> </data>
Обратите внимание, на формат даты/времени: указывать необходимо в формате MySQL.
Задача 3. Требуется отправить следующий текст: «Добрый день, приглашаем Вас в наш салон», с подписью «Magazin» на 3 номера: +79019011234, +79029021234, +79039031234. СМС необходимо отправить 1 февраля 2010 в 12:00:00 и повторить на те же номера с тем же текстом в 18:00:00. Отчет о доставленных СМС должен быть сгруппирован в один (для этих целей и существует параметр SMSID). По сути, SMSID – идентификатор рассылки, чтобы получить более удобный отчет. Если Вы будете отправлять 1000 СМС по одной, каждый раз отправляя POST запрос, то у Вас будет 1000 отчетов о доставке, что не совсем удобно в обработке.
Решение:
На адрес https://lcab.smsint.ru/API/XML/send.php необходимо методом POST отправить следующие XML (по очереди):
<?xml version='1.0' encoding='UTF-8'?> <data> <login>test</login> <password>123456</password> <smsid>abcde123</smsid> <action>send</action> <datetime>2010-02-01 12:00:00</datetime> <text>Добрый день, приглашаем Вас в наш салон</text> <source>Magazin</source> <to number='+79019011234'></to> <to number='7-902-902-12 34'></to> <to number='89039031234'></to> </data>
<?xml version='1.0' encoding='UTF-8'?> <data> <login>test</login> <password>123456</password> <smsid>abcde123</smsid> <action>send</action> <datetime>2010-02-01 18:00:00</datetime> <text>Добрый день, приглашаем Вас в наш салон</text> <source>Magazin</source> <to number='+79019011234'></to> <to number='7-902-902-12 34'></to> <to number='89039031234'></to> </data>
Обратите внимание, чтобы сгруппировать 2 рассылки в 1, для более удобного отчета (в данном примере для решения задачи), мы использовали параметр smsid=abcde123.
Описание возвращаемых кодов
Код | Описание |
---|---|
500 | Недостаточно переданных параметров (связана обычно с тем, что не передан какой-то параметр, обязательный для рассылки) |
501 | Не удалось авторизоваться |
502 | Недопустимое значение Адреса отправителя (связана обычно с тем, что задан не GSM формат подписи, либо подпись не одобрена в личном кабинете) |
510 | Отсутствуют получатели (связана обычно с тем, что не передан ни один получатель) |
511 | Ваша учетная запись заблокирована |
512 | Модуль отправки СМС не подключен |
516 | Недостаточно средств для выполнения рассылки. |
517 | СМС не будет доставлена ни одному получателю (связана обычно с тем, что номера не из мобильной сети, либо направление отключено в тарифном плане) |
518 | Недопустимое значение даты/времени |
519 | Использование цифровой подписи на дорогом канале недопустимо. |
7xx | Ошибка парсера XML (возникает, когда присылается некорректная ХМЛ) |
Отмена СМС
Для отмены рассылки необходимо передать методом POST на адрес https://lcab.smsint.ru/API/XML/cancel.php следующую XML.
<?xml version='1.0' encoding='UTF-8'?> <data> <login>LOGIN</login> <password>PASSWORD</password> <smsid>SMSID</smsid> </data>
Параметр | Описание | Обязательный параметр |
---|---|---|
<login>LOGIN</login> | Вместо LOGIN необходимо подставить Ваш логин. | Да |
<password>PASSWORD</password> | Вместо PASSWORD необходимо подставить Ваш пароль. | Да |
<smsid>SMSID</smsid> | SMSID – идентификатор СМС (группы СМС). Данный параметр необходим для идентификации отправляемой СМС (группы СМС). | Да |
Ответ сервера:
<?xml version='1.0' encoding='UTF-8'?> <data> <code>CODE</code> <descr>DESCR</descr> <cancelCol>CANCELCOL</ cancelCol > </data>
Параметр | Описание |
---|---|
code | Код результата обработки (1 - успех, иначе - ошибка) |
descr | Описание результата обработки |
cancelCol | Кол-во отмененных СМС |
Важное примечание: вы можете отменить только те СМС, которые не ушли в сеть оператора!
Список рассылок
Чтобы получить список рассылок за определенный период, необходимо передать методом POST на адрес: https://lcab.smsint.ru/API/XML/report.php следующую XML:
<?xml version='1.0' encoding='UTF-8'?> <data> <login>LOGIN</login> <password>PASSWORD</password> <start>START</start> <stop>STOP</stop> <source>SOURCE</source> </data>
Параметр | Описание | Обязательный параметр |
---|---|---|
<login>LOGIN</login> | Вместо LOGIN необходимо подставить Ваш логин. | Да |
<password>PASSWORD</password> | Вместо PASSWORD необходимо подставить Ваш пароль. | Да |
<start>START</start> | Вместо START необходимо подставить дату начала отчета | Нет, по умолчанию ставится дата регистрации компании в системе |
<stop>STOP</stop> | Вместо STOP необходимо подставить дату окончания отчета | Нет, по умолчанию ставится сегодняшняя дата |
<source>SOURCE</source> | Вместо SOURCE необходимо подставить имя отправителя | Нет |
Ответ сервера:
<?xml version='1.0' encoding='UTF-8'?> <data> <code>CODE</code> <descr>DESCR</descr> <sms> <smsid>SMSID1</smsid> <datetime>DATETIME1</datetime> <text>TEXT1</text> <source>SOURCE1</source> <allCol>5</allCol> <deliveredCol>3</deliveredCol> <notDeliveredCol>1</notDeliveredCol> <waitingCol>0</waitingCol> <enqueuedCol>1</enqueuedCol> <payment>23.11</payment> </sms> <sms> <smsid>SMSID2</smsid> <datetime>DATETIME2</datetime> <text>TEXT2</text> <source>SOURCE2</source> <allCol>5</allCol> <deliveredCol>3</deliveredCol> <notDeliveredCol>1</notDeliveredCol> <waitingCol>0</waitingCol> <enqueuedCol>1</enqueuedCol> <payment>12.59</payment> </sms> </data>
Параметр | Описание |
---|---|
code | Код результата обработки (1 - успех, иначе - ошибка) |
descr | Описание результата обработки |
smsid | Идентификатор СМС (группы СМС). Данный параметр необходим для идентификации отправляемой СМС (группы СМС), в том числе, для получения по SMSID результатов отправки. Обратите внимание, что в данном отображении, идентификатор выдан системой (отличается от SMSID, указанного при отправке СМС) |
datetime | Дата/время отправки СМС (группы СМС) |
text | Текст отправленной СМС. |
source | Адрес отправителя отправленной СМС. |
allCol | Общее количество абонентов, которым было отправлено СМС. |
deliveredCol | Количество доставленных сообщений |
notDeliveredCol | Количество не доставленных сообщений. |
waitingCol | Количество сообщений в статусе ОЖИДАНИЕ. |
enqueuedCol | Количество отправленных сообщений, отчет по которым еще не был получен. |
payment | Стоимость рассылки. |
Отчет по рассылке
Чтобы получить детализацию рассылки, необходимо передать методом POST на адрес: https://lcab.smsint.ru/API/XML/report.php следующую XML:
<?xml version='1.0' encoding='UTF-8'?> <data> <login>LOGIN</login> <password>PASSWORD</password> <smsid>SMSID</smsid> </data>
Параметр | Описание | Обязательный параметр |
---|---|---|
<login>LOGIN</login> | Вместо LOGIN необходимо подставить Ваш логин. | Да |
<password>PASSWORD</password> | Вместо PASSWORD необходимо подставить Ваш пароль. | Да |
<smsid>SMSID</smsid> | SMSID - идентификатор СМС (группы СМС). Обратите внимание, что можно указать идентификатор, выданный системой в разделе «Список СМС». Также можно указать идентификатор, указанный (выданный) при отправке СМС. | Да |
Ответ сервера в случае передачи SMSID, присвоенного при отправке СМС:
<?xml version='1.0' encoding='UTF-8'?> <data> <code>CODE</code> <descr>DESCR</descr> <detail> <delivered> <number>79010000000</number> </delivered> <notDelivered> <number>79020000000</number> </notDelivered> <waiting> <number>79030000000</number> </waiting> <enqueued> <number>79040000000</number> </enqueued> <cancel> <number>79050000000</number> </cancel> <onModer> <number>79060000000</number> </onModer> <process> <number>79070000000</number> </process> </detail> </data>
Параметр | Описание |
---|---|
code | Код результата обработки (1 - успех, иначе - ошибка) |
descr | Описание результата обработки |
delivered | Список абонентов, получивших СМС |
notDelivered | Список абонентов, не получивших СМС |
waiting | Список абонентов, СМС для которых находится в статусе "В ожидании" |
enqueued | Список абонентов, отчет о доставке по которым еще не сформирован |
cancel | Список отмененных номеров |
onModer | Список номеров, сообщения для которых находятся на модерации |
Ответ сервера в случае передачи SMSID, полученного в списке СМС-рассылок за период (предыдущий раздел руководства):
<?xml version='1.0' encoding='UTF-8'?> <data> <code>CODE</code> <descr>DESCR</descr> <sms> <smsid>SMSID</smsid> <datetime>DATETIME</datetime> <text>TEXT</text> <source>SOURCE</source> <allCol>RECEIVERS COUNT</allCol> <deliveredCol>DELIVERED COUNT</deliveredCol> <notDeliveredCol>NOT DELIVERED COUNT</notDeliveredCol> <waitingCol>WAITING COUNT</waitingCol> <enqueuedCol>SENDED COUNT</enqueuedCol> <processCol>PROCESS COUNT</processCol> <payment>PAYMENT</payment> </sms> <detail> <delivered> <number>NUMBER1</number> <number>NUMBER2</number> </delivered> <notDelivered> <number>NUMBER3</number> <number>NUMBER4</number> </notDelivered> <waiting> <number>NUMBER5</number> </waiting> <enqueued> <number>NUMBER6</number> </enqueued> <cancel> <number>NUMBER7</number> </cancel> <onModer> <number>NUMBER8</number> </onModer> <process> <number>NUMBER9</number> </process> </detail> </data>
Параметр | Описание |
---|---|
code | Код результата обработки (1 - успех, иначе - ошибка) |
descr | Описание результата обработки |
<sms>…</sms> | В этом блоке находится информация о рассылке. |
smsid | Идентификатор СМС (группы СМС). Данный параметр необходим для идентификации отправляемой СМС (группы СМС). |
datetime | Дата/время отправки СМС (группы СМС). |
text | Текст отправленной СМС, как он виден в отчетах (отличается от реального). |
source | Адрес отправителя отправленной СМС. |
allCol | Общее количество абонентов, которым было отправлено СМС. |
deliveredCol | Количество доставленных СМС. |
notDeliveredCol | Количество не доставленных СМС. |
waitingCol | Количество СМС в статусе ОЖИДАНИЕ. |
enqueuedCol | Количество СМС без отчета. |
payment | Стоимость рассылки. |
<detail>…</detail> | В этом блоке находится детальная информация о рассылке. |
delivered | Список абонентов, получивших СМС |
notDelivered | Список абонентов, не получивших СМС |
waiting | Список абонентов, СМС для которых находится в статусе "В ожидании" |
enqueued | Список абонентов, отчет о доставке по которым еще не сформирован |
cancel | Список отмененных номеров |
onModer | Список номеров, сообщения для которых находятся на модерации |
Все СМС на номер
Чтобы получить список всех СМС на номер абонента за определенный период, необходимо передать методом POST на адрес: https://lcab.smsint.ru/API/XML/reportNumber.php следующую XML:
<?xml version='1.0' encoding='UTF-8'?> <data> <login>LOGIN</login> <password>PASSWORD</password> <start>START</start> <stop>STOP</stop> <number>NUMBER</number> </data>
Параметр | Описание | Обязательный параметр |
---|---|---|
<login>LOGIN</login> | Вместо LOGIN необходимо подставить Ваш логин. | Да |
<password>PASSWORD</password> | Вместо PASSWORD необходимо подставить Ваш пароль. | Да |
<start>START</start> | Вместо START необходимо подставить дату начала отчета | Нет, по умолчанию ставится дата регистрации компании в системе |
<stop>STOP</stop> | Вместо STOP необходимо подставить дату окончания отчета | Нет, по умолчанию ставится сегодняшняя дата |
<number>NUMBER</number> | Вместо NUMBER необходимо подставить номер телефона | Нет |
Ответ сервера:
<?xml version='1.0' encoding='UTF-8'?> <data> <code>CODE</code> <descr>DESCR</descr> <sms> <smsid>SMSID1</smsid> <datetime>DATETIME1</datetime> <text>TEXT1</text> <source>SOURCE1</source> <status>STATUS1</status> </sms> <sms> <smsid>SMSID2</smsid> <datetime>DATETIME2</datetime> <text>TEXT2</text> <source>SOURCE2</source> <status>STATUS2</status> </sms> </data>
Параметр | Описание |
---|---|
code | Код результата обработки (1 - успех, иначе - ошибка) |
descr | Описание результата обработки |
smsid | Идентификатор СМС (группы СМС). Данный параметр необходим для идентификации отправляемой СМС (группы СМС), в том числе, для получения по SMSID результатов отправки. Обратите внимание, что в данном отображении, идентификатор выдан системой (отличается от SMSID, указанного при отправке СМС) |
datetime | Дата/время отправки СМС |
text | Текст отправленной СМС. |
source | Адрес отправителя отправленной СМС. |
status | Статус сообщения. delivered - доставлено, not_delivered - не доставлено, process - в процессе отправки, waiting - отложена, enqueued и sending - в сети, cancel - отменена, on_moder - на модерации |
Проверка СМС купона
Чтобы проверить уникальный код, отправленный из раздела Акций необходимо передать методом POST на адрес https://lcab.smsint.ru/API/XML/checkcode.php следующую XML.
<?xml version='1.0' encoding='UTF-8'?> <data> <login>LOGIN</login> <password>PASSWORD</password> <code>CODE</code> <markAsUsed>1 или 0</markAsUsed> <phone>PHONE</phone> </data>
Описание параметров:
Параметр | Описание | Обязательный параметр |
---|---|---|
<login>LOGIN</login> | Вместо LOGIN необходимо подставить логин менеджера из раздела акций | Да |
<password>PASSWORD</password> | Вместо PASSWORD необходимо подставить пароль менеджера из раздела акций | Да |
<code>CODE</code> | CODE – уникальный код, который называет клиент. | Да |
<markAsUsed>1</markAsUsed> | Помечать код использованным (1) или нет (0) | Нет, по-умолчанию стоит "1" (помечать использованным) |
<phone>PHONE</phone> | Если указан, то проверить еще и номер телефона | Нет |
Ответ сервера:
<?xml version='1.0' encoding='UTF-8'?> <data> <code>CODE</code> <descr>DESCR</descr> <managerText>MANAGERTEXT</managerText> <phone>PHONE</phone> </data>
Параметр | Описание |
---|---|
code | Код результата обработки (1 - успех, иначе - ошибка) |
descr | Описание результата обработки |
managerText | В случае, если code = 1 (т.е. проверка кода завершена успешно) в этом тэге будет содержаться текст с инструкцией для менеджера - что необходимо выдать клиенту. |
phone | В случае, если code = 1 (т.е. проверка кода завершена успешно) в этом тэге будет содержаться номер телефона клиента. |
Проверка баланса
Для проверки баланса, необходимо передать методом POST на адрес https://lcab.smsint.ru/API/XML/balance.php следующую XML
<?xml version='1.0' encoding='UTF-8'?> <data> <login>LOGIN</login> <password>PASSWORD</password> </data>
Описание параметров:
Параметр | Описание | Обязательный параметр |
---|---|---|
<login>LOGIN</login> | Вместо LOGIN необходимо подставить Ваш логин | Да |
<password>PASSWORD</password> | Вместо PASSWORD необходимо подставить Ваш пароль | Да |
Ответ сервера:
<?xml version='1.0' encoding='UTF-8'?> <data> <code>CODE</code> <descr>DESCR</descr> <account>ACCOUNT</account> </data>
Параметр | Описание |
---|---|
code | Код результата обработки (1 - успех, иначе - ошибка) |
descr | Описание результата обработки |
account | Значение баланса, тип FLOAT |