...
В случае получения правильного XML-документа:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8" ?> |
...
<response> |
...
<phone>79612242243</phone> |
...
<phone>79612242244</phone> |
...
… |
...
</response> |
...
Где,
phone
...
– Номер телефона из СТОП-листа.
...
...
Запрос на добавление/удаление абонентов в СТОП-лист
...
Адрес сервера:
| Code Block |
|---|
...
https:// |
...
clk2. |
...
prontosms.ru/xml/stop.php |
...
XML-документ:
| Code Block |
|---|
<?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> |
Где,
loginvalue -
...
ваш логин в системе
passwordvalue -
...
ваш пароль в системе
add_stopphone –
...
номер телефона абонента, которого нужно добавить в СТОП-лист.
delete_stopphone –
...
номер телефона абонента, которого нужно удалить из СТОП-листа.
В ответ может быть выдан один из следующих XML-документов:
В случае возникновения ошибки в отправляемом XML-документе:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8"?> |
...
<response> |
...
<error>текстошибки</error> |
...
</response> |
...
error - текст ошибки может принимать следующие значения:
Неправильный формат XML документа
Неправильный логин или пароль
POST данные отсутствуют
...
В случае получения правильного XML-документа:
| Code Block |
|---|
<?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
...
Адрес сервера:
| Code Block |
|---|
...
https:// |
...
clk2. |
...
prontosms.ru/xml/list_scheduled.php |
XML-документ:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8" ?> |
...
<request> |
...
<security> |
...
<login value="логин" /> |
...
<password value="пароль" /> |
...
</security> |
...
<scheduled page=”1”/> |
...
</request> |
...
Где,
loginvalue - вашлогинвсистеме
passwordvalue - ваш пароль в системе
scheduledpage – Номер страницы. Весь список запланированных SMS делится на страницы. Запросить список целиком нельзя. Можно лишь запросить отдельную страницу. Нумерация начинается с единички.
В ответ В ответ может быть выдан один из следующих XML-документов:
В случае возникновения ошибки в отправляемом XML-документе:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8"?> |
...
<response> |
...
<error>текстошибки</error> |
...
</response> |
error - текст ошибки может принимать следующие значения:
Неправильный формат XML документа
Неправильный логин или пароль
POST данные отсутствуют
В случае получения правильного XML-документа:
| Code Block |
|---|
<?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> |
...
Где,
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
...
Адрес сервера:
| Code Block |
|---|
...
https:// |
...
clk2. |
...
prontosms.ru/xml/scheduled.php |
XML-документ:
| Code Block |
|---|
<?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> |
...
Где,
loginvalue -
...
ваш логин в системе
passwordvalue -
...
ваш пароль в системе
delete_scheduleid_sms –
...
номер запланированной SMS, которую нужно удалить. Можно получить при запросе списка запланированных SMS.
В ответ может быть выдан один из следующих XML-документов:
В случае возникновения ошибки в отправляемом XML-документе:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8"?> |
...
<response> |
...
<error>текстошибки</error> |
...
</response> |
...
error - текст ошибки может принимать следующие значения:
Неправильный формат XML документа
Неправильный логин или пароль
POST данные отсутствуют
...
В случае получения правильного XML-документа:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8" ?> |
...
<response> |
...
<scheduled id_sms="1234">delete</scheduled> |
...
<scheduled id_sms="1235">not_found</scheduled> |
...
… |
...
</response> |
...
...
Запрос на получение времени изменения чего либо
...
Адрес сервера:
| Code Block |
|---|
...
https:// |
...
clk2. |
...
prontosms.ru/xml/check_change.php |
...
XML-документ:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8" ?> |
...
<request> |
...
<security> |
...
<login value="логин" /> |
...
<password value="пароль" /> |
...
</security> |
...
<check obgect="base" id="1"/> |
...
</request> |
...
Где,
login value -
...
ваш логин в системе
password value - ваш пароль в системе
obgect – base – базы данных, stop-
...
стоп лист
В ответ может быть выдан один из следующих XML-документов:
В случае возникновения ошибки в отправляемом XML-документе:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8"?> |
...
<response> |
...
<error>текстошибки</error> |
...
</response> |
...
error - текст ошибки может принимать следующие значения:
Неправильный формат XML документа
Неправильный логин или пароль
POST данные отсутствуют
Базы с таким номером не существует
В случае получения правильного XML-документа:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8" ?> |
...
<response> |
...
<obgect time_update="2012-01-01 12:12:12" /> |
...
</response> |
...
Где,
time_update – время последнего изменения объекта
Запрос проверки времени
...
Адрес сервера:
| Code Block |
|---|
...
https:// |
...
clk2. |
...
prontosms.ru/xml/time.php |
...
XML-документ:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8" ?> |
...
<request> |
...
<security> |
...
<login value="логин" /> |
...
<password value="пароль" /> |
...
</security> |
...
</request> |
...
Где,
login value – ваш логин в системе
password value - ваш пароль в системе
...
В ответ может быть выдан один из следующих XML-документов:
В случае возникновения ошибки в отправляемом XML-документе:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8"?> |
...
<response> |
...
<error>текст ошибки</error> |
...
</response> |
error - текст ошибки может принимать следующие значения:
Неправильный формат XML документа
Неправильный логин или пароль
POST данные отсутствуют
В случае получения правильного XML-документа:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8" ?> |
...
<response> |
...
<time>15:34:05</time> |
...
</response> |
...
Где,time –
time – локальное время пользователя.
При этом время рассчитывается как время на сервере минус разница часовых поясов пользователя и сервера.
Пример
Сервер находиться в Москве и серверное время у него московское, в момент запроса оно составляло: 15:34:27.
А пользователь числился в Новосибирске и разница часовых поясов (между сервером и пользователём) у него равнялось +3.
При этом вам вернется XMLдокумент XML документ следующего содержания.:
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8"?> |
...
<response> |
...
<time>2012-12-17 18:34:27</time> |
...
</response> |
Запрос на загрузку файлов
...
Адрес сервера:
| Code Block |
|---|
...
https:// |
...
clk2. |
...
prontosms.ru/xml/file.php |
Для загрузки файла на сервер необходимо отправить POST данные содержащие переменные login, password, file. В ответ будет выдан id сохраненного файла, который в дальнейшем вы можете использовать в xml-запросах.
Пример php кода для загрузки файла:
| Code Block |
|---|
$href = " |
...
https:// |
...
clk2. |
...
prontosms.ru/xml/file.php"; |
...
$tmpfname = "имя"; |
...
$requist['login'] = "логин"; |
...
$requist['passsword'] = "пароль"; |
...
if(PHP_VERSION_ID < 56000) |
...
$requist['file'] = '@' . $tmpfname; |
...
else
...
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 вашего сохраненного файла.
...
Возможные ошибки:
Не удалось скопировать файл!
Неверный логин или пароль!