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

На определенный адрес сервера отправляются 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 = 'https://clk.prontosms.ru/script.php'; // адрес сервера
$ch = curl_init();
curl_setopt ($ch, CURLOPT_HTTPHEADER, array ('Content-type: text/xml','charset=utf-8','Expect:'));
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt ($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt ($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt ($ch, CURLOPT_POST, true);
curl_setopt ($ch, CURLOPT_POSTFIELDS, $src);
curl_setopt ($ch, CURLOPT_URL, $href);
$result = curl_exec($ch);
curl_close($ch);
echo $result;

Отправка SMS

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

https://clk.prontosms.ru/xml/

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<message type="sms">
    <sender>Отправитель 1</sender>
    <text>Текст сообщения 1</text>
    <translite>1</translite>
    <name_delivery>Рассылка 1</name_delivery>
    <abonent phone="79033256699" number_sms="1" client_id_sms="101" time_send="2001-12-31 12:34" validity_period="2001-12-31 15:34" />
    <abonent phone="79033256699" number_sms="2" client_id_sms="102" time_send="2001-12-31 12:35" />
    <abonent phone="79033256699" number_sms="10" client_id_sms="110" time_send="" />
</message>
<message>
    <sender>Отправитель 2</sender>
    <text>Текст сообщения 2</text>
    <name_delivery>Рассылка 2</name_delivery>
    <abonent phone="79033256699" number_sms="11" client_id_sms="111" />
    <abonent phone="79033256699" number_sms="12" client_id_sms="112" />
    <abonent phone="79033256699" number_sms="20" client_id_sms="120" />
</message>
</request>

Где

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
<error>текст ошибки</error>
</response>

error

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

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<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>

Где:

    1. У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером.
    2. Закончились SMS.
    3. Аккаунт заблокирован.
    4. Укажите номер телефона.
    5. Номер телефона присутствует в стоп-листе.
    6. Данное направление закрыто для вас.
    7. Данное направление закрыто.
    8. Недостаточно средств для отправки SMS. SMS будет отправлена как только вы пополните счет по данному направлению.
    9. Текст SMS отклонен модератором.
    10. Нет отправителя.
    11. Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых.
    12. Номер телефона должен быть меньше 15 символов.
    13. Нет текста сообщения.
    14. Нет ссылки.
    15. Такого отправителя Нет.
    16. Отправитель не прошел модерацию.
    17. Данное сообщение уже было отправлено.

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

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

https://clk.prontosms.ru/xml/state.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<get_state>
    <id_sms>IDSMS в системе для проверки статуса</id_sms>
    <id_sms>IDSMS в системе для проверки статуса</id_sms>
    <id_sms>IDSMS в системе для проверки статуса</id_sms>
    <id_sms>IDSMS в системе для проверки статуса</id_sms>
</get_state>
</request>

Где

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" num_parts="2" price="1.15">Статус</state>
<state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" num_parts="2" price="1.15">Статус</state>
<state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" num_parts="2" price="1.15">Статус</state>
</response>

Где

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

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

К примеру, в php XML-документ будет доступен через переменную

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

Где:

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
    <id_sms>3234</id_sms>
    <id_sms>3234</id_sms>
</response>

Где:

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

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

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

https://clk.prontosms.ru/xml/balance.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
</request>

Где

В ответ может быть выдан один из следующих XML-документов: 1. В случае возникновения ошибки в отправляемом XML-документе:

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
    <money currency="RUR">150</money>
    <sms area="Россия">111</sms>
    <sms area="Украина">111</sms>
</response>

Где:

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

Пример

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<money>10</money>
<sms area="Россия">10</sms>
<sms area="Украина">5</sms>
</response>

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
    <money>8</money>
    <sms area="Россия">8</sms>
    <sms area="Украина">4</sms>
</response>

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

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

https://clk.prontosms.ru/xml/originator.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
    <any_originator>FALSE</any_originatоr>
    <list_originator>
        <originator state="rejected">Отправитель</originator>
    </list_originator>
</response>

Где

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

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

https://clk.prontosms.ru/xml/incoming.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
    <security>
        <login value="логин" />
        <password value="пароль" />
    </security>
<time start="2012-01-31 12:23:00" end="2012-02-31 12:23:00" />
</request>

Где

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<sms id_sms="1234" date_receive="2012-01-31 12:55:55" originator="79612242243" prefix="IGRA" phone="79611111111">ТекстСМС.</sms>
<sms id_sms="1234" date_receive="2012-01-31 12:55:55" originator="79612242243" prefix="IGRA" phone="79611111111">ТекстСМС.</sms>
</response>

Где

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

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

https://clk.prontosms.ru/xml/def.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<phones>
    <phone>79612242243</phone>
    <phone>79612242244</phone>
</phones>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
<error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
    <phone operator="Вымпелтелеком" region="Новосибирскаяобласть" time_zone="3">79612242243</phone>
    <phone operator="Вымпелтелеком" region="Калининград" time_zone="-1">79612242244</phone>
</response>

Где:

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

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

https://clk.prontosms.ru/xml/list_bases.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
    <security>
        <login value="логин" />
        <password value="пароль" />
    </security>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<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>

Где:

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

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

https://clk.prontosms.ru/xml/bases.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</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>
    <base id_base="1235" />
    <base id_base="1236" />
</delete_bases>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<base id_base="1234">edit</base>
<base number_base="1" id_base="1235">insert</ base>
<base number_base="2" id_base="1236">edit</ base>
<base id_base="1235">delete</ base>
<base id_base="1235">not_found</ base>
</response>

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

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

https://clk.prontosms.ru/xml/list_phones.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<base id_base="1234" page="1" last_update="2011-03-25 08:39:48"/>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<phones page="1" num_pages="100">
<phone phone="79612242243" region="Новосибирск " operator="Вымпелком" name="Константин" surname="Ермолаев" patronymic="Александрович" date_birth="1984-08-21" male="m" addition_1="Первоедополнительноеполе" addition_2="второе" addition_3="третье" addition_4="четвертое" addition_5="пятое" last_update="2011-03-25 08:39:48" />
<phone phone="79612242244" region="Новосибирск" operator="Вымпелком" name="Константин" surname="Ермолаев" patronymic="Александрович" date_birth="1984-08-21" male="m" addition_1="Первоедополнительноеполе" addition_2="второе" addition_3="третье" addition_4="четвертое" addition_5="пятое" last_update="2011-03-25 08:39:48" />
</phones>
</response>

Где:

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

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

https://clk.prontosms.ru/xml/phones.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<base id_base="1234">
<phone phone="79612242243" region="Новосибирск " operator="Вымпелком" name="Константин" surname="Ермолаев" patronymic="Александрович" date_birth="1984-08-21" male="мужской" addition_1="Первоедополнительноеполе" addition_2="второе" addition_3="третье" addition_4="четвертое" addition_5="пятое" number_phone="1"/>
<phone phone="79612242244" region="Новосибирск " operator="Вымпелком" name="Константин" surname="Ермолаев" patronymic="Александрович" date_birth="1984-08-21" male="мужской" addition_1="Первоедополнительноеполе" addition_2="второе" addition_3="третье" addition_4="четвертое" addition_5="пятое" number_phone="2" />
<phone phone="79612242243" action="delete" number_phone="5"/>
<phone phone="79612242244" action="delete" number_phone="6"/>
</base>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текстошибки</error>
</response>

error

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

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<baseid_base="1234">
<phone phone="79612242243" number_phone="1"/>insert</phone>
<phone phone="79612242244" number_phone="2" />edit</phone>
<phone phone="79612242243" number_phone="5"/>delete</phone>
<phone phone="79612242244" number_phone="6" />not_found</phone>
</response>

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

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

https://clk.prontosms.ru/xml/list_stop.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" /> <password value="пароль" />
</security>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
<error>текстошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<phone>79612242243</phone>
<phone>79612242244</phone>
</response>

Где:

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

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

https://clk.prontosms.ru/xml/stop.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<add_stop>
    <phone phone="79612242243" />
    <phone phone="79612242244" />
</add_stop>
<delete_stop>
    <phone phone="79612242243" />
    <phone phone="79612242244" />
</delete_stop>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
    <phone phone="79612242243">delete</phone>
    <phone phone="79612242244">add</phone>
    <phone phone="79612242245">not_found</phone>
</response>

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

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

https://clk.prontosms.ru/xml/list_scheduled.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<scheduled page="1"/>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<phones page="1" num_pages="100">
<scheduled id_sms="1234" time_put_turn="2011-11-14 12:42:40" originator="kosty"  phone="79612242243" type_sms="sms" text_sms="ТекстSMS" count_sms="2" name_delivery="Названиерасылки" time_send="2011-11-14 21:00" validity_period="2011-11-17 21:00:00" />
<scheduled id_sms="1235" time_put_turn="2011-11-14 12:42:40" originator="kosty" phone="79612242244" type_sms="sms" text_sms="ТекстSMS" count_sms="2" name_delivery="Названиерасылки" time_send="2011-11-14 21:00" validity_period="2011-11-17 21:00:00" />
</phones>
</response>

Где:

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

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

https://clk.prontosms.ru/xml/scheduled.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<delete_schedule>
    <schedule id_sms="1234" />
    <schedule id_sms="1235" />
</delete_schedule>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текстошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
    <scheduled id_sms="1234">delete</scheduled>
    <scheduled id_sms="1235">not_found</scheduled>
</response>

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

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

https://clk.prontosms.ru/xml/check_change.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<check obgect="base" id="1"/>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
    <obgect time_update="2012-01-01 12:12:12" />
</response>

Где

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

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

https://clk.prontosms.ru/xml/time.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
<error>текстошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<time>15:34:05</time>
</response>

Где:

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

Пример

Сервер находится в Москве и серверное время у него московское, в момент запроса оно составляло: 15:34:27. А пользователь числился в Новосибирске и разница часовых поясов (между сервером и пользователем) у него равнялась +3. При этом вам вернется XML документ следующего содержания:

<?xml version="1.0" encoding="utf-8"?>
<response>
    <time>2012-12-17 18:34:27</time>
</respo

Запрос на получение списка шаблонов SMS

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

https://clk.prontosms.ru/xml/list_patterns.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
    <security>
        <login value="логин" />
        <password value="пароль" />
    </security>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<pattern id_pattern="1234" name="ЗаголовокШаблона1">Шаблон1</pattern>
<pattern id_pattern="1235" name="ЗаголовокШаблона2">Шаблон2</pattern>
</response>

Где:

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

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

https://clk.prontosms.ru/xml/patterns.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<patterns>
<pattern id_pattern="1234" name="ЗаголовокШаблона1">Шаблон1</base>
<pattern id_pattern="1235" name="ЗаголовокШаблона2">Шаблон2</base>
<pattern number_pattern="1" name="ЗаголовокШаблона3">Шаблон3</pattern>
</patterns>
<delete_patterns>
    <pattern id_pattern="1236" />
    <pattern id_pattern="1237" />
</delete_patterns>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<pattern id_pattern="1234">edit</pattern>
<pattern id_pattern="1235">not_edit</ pattern>
<pattern number_base="1" id_pattern="1238">insert</ pattern>
<pattern id_pattern="1236">delete</ pattern>
<pattern id_pattern="1237">not_found</ pattern>
</response>

Где:

Запрос на получение реестра имен отправителей

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

https://clk.prontosms.ru/xml/list_registry_originator.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<registry_originator operator="Оператор" originator="Имя отправителя" inn="ИНН"></registry_originator>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<registry_originator>
    <operator name="mts" title="МТС">
        <originator originator="Отправитель 1" date_from="2017-05-20" legal_entity="ИП Иванов" inn="ИНН" comment="Комментраий" status="approval" status_text="Согласовано"></originator>
        <originator originator="Отправитель 2" date_from="2017-05-20" legal_entity="ИП Иванов" inn="ИНН" comment="Комментраий" status="posted_for_approval" status_text="Подано на согласование"></originator>
    </operator>
    <operator name="mega" title="Мегафон">
        <originator originator="Отправитель 1" date_from="2017-05-20" legal_entity="ИП Иванов" inn="ИНН" comment="Комментраий" status="approval" status_text="Согласовано"></originator>
        <originator originator="Отправитель 2" date_from="2017-05-20" legal_entity="ИП Иванов" inn="ИНН" comment="Комментраий" status="posted_for_approval" status_text="Подано на согласование"></originator>
    </operator>
</registry_originator>
</response>

Где:

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

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

https://clk.prontosms.ru/xml/registry_originator.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<registry_originator>
    <originator originator="Отправитель 1" legal_entity="ИП Иванов" operator="mts" inn="ИНН" comment="Комментарий"></originator>
    <originator originator="Отправитель 1" legal_entity="ИП Иванов" operator="tele2" inn="ИНН" comment="Комментарий"></originator>
    <originator originator="Отправитель 2" legal_entity="ИП Иванов" operator="mts" inn="ИНН"></originator>
</registry_originator>
<delete_registry_originator>
    <originator originator="Отправитель 3"></originator>
    <originator originator="Отправитель 4" operator="mega"></originator>
</delete_registry_originator>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<registry_originator>
    <originator originator="Отправитель 1" operator="mts" inn="ИНН" status="add" error=""></originator>
    <originator originator="Отправитель 1" operator="tele2" inn="ИНН" status="error" error="Описание ошибки"></originator>
    <originator originator="Отправитель 2" operator="mts" inn="ИНН" status="add" error=""></originator>
</registry_originator>
<delete_registry_originator>
    <originator originator="Отправитель 3" operator="" status="delete" error=""></originator>
    <originator originator="Отправитель 4" operator="mega" status="not_found" error="Имя отправителя не обнаружено"></originator>
</delete_registry_originator>
</response>

Где:

Запрос на просмотр и редактирования ссылки получения статусов СМС по XML протоколу

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

https://clk.prontosms.ru/xml/get_state.php

XML-документ:

<?xml version="1.0" encoding="utf-8" ?>
<request>
<security>
    <login value="логин" />
    <password value="пароль" />
</security>
<get_state type="set">http://site.ru/state.php</get_state>
</request>

Где:

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

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

<?xml version="1.0" encoding="utf-8"?>
<response>
    <error>текст ошибки</error>
</response>

error

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

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

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
<get_state>http://site.ru/state.php</get_state>
</response>

Где: