Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 - текст ошибки может принимать следующие значения:

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

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

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

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

 

 

В случае получения правильного 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 - текст ошибки может принимать следующие значения:

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

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

  3. 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 вашего сохраненного файла.

...

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

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

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