Расширение API для отправки сообщений в приложение Viber

Расширение API для отправки сообщений в приложение Viber

Структура HTTP POST-запроса

Основные параметры:

[user] => login		зарегистрированное в системе ID пользователя вида XXXXX или ХХХХХ.X
[pass] => password	пароль пользователя
Адрес обращения:	http://web.smsgold.ru/http2/ или https://web.smsgold.ru/http2/
Тип авторизации:	PLAIN (открытым текстом)
Метод отправки запроса:	POST

Максимальная длина сообщений: 1000 символов.

Авторизация

Предварительная загрузка картинки

Для отправки сообщения, содержащего картинку, необходима предварительная загрузка картинки на платформу и получение идентификатора (определить, что идет загрузка картинки можно по полю [action] => imageviload):

• Пример запроса к серверу для предварительной загрузки картинки...

  Пример запроса на PHP:
  <?php
  header('Content-type: text/xml');
  $ch = curl_init();
  $data = array(
      'user'         => '10XXX',
      'pass'         => 'PASSWORD',
      'action'       => 'imageviload',
      'imagevi_file' =>  base64_encode(file_get_contents("./path/file_name.jpg"))
      );
  curl_setopt($ch, CURLOPT_URL, 'http://web.smsgold.ru/http2/');
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_HEADER, false);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30);
  curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
  $res = curl_exec($ch);
  curl_close($ch);
  echo $res;
  ?>
  

• Пример ответа сервера на запрос для предварительной загрузки картинки (развернуть)...

  <?xml version="1.0" encoding="UTF-8"?>
  <output>
  <xml_result action="http_post_imageviload" err="">
  	<result format="JPG/GIF/PNG">
  	<imagevi imagevi_id="XXXXXXXXXXX" err="" description="картинка успешно загружена"></imagevi>
  	</result>
  </xml_result>
  </output>
  
  *err=""	- номер ошибки, возникшей при загрузке, если ошибки нет, то err=null либо err="0"
  

Отправка сообщения

Параметры передачи сообщения http-серверу в виде POST-запроса (определить, что идет отправка сообщения можно по полю [action] => sendviber):

• Пример запроса к серверу для отправки текста на несколько номеров...

  Пример запроса на PHP:
  <?php
  header('Content-type: text/xml');
  $ch = curl_init();
  $data = array(
      'user'   => '10XXX',
      'pass'   => 'PASSWORD',
      'action' => 'sendviber',
      'sender' => 'SmsGold',
      'number' => '79XXXXXXXXX, 79XXXXXXXXX, ...',
      'imagevi_id'   => 'XXXXXXXXXXX',
      'buttonvi_text'   => 'Текст кнопки',
      'buttonvi_link'   => 'Ссылка кнопки'
      );
  curl_setopt($ch, CURLOPT_URL, 'http://web.smsgold.ru/http2/');
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_HEADER, false);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30);
  curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
  $res = curl_exec($ch);
  curl_close($ch);
  echo $res;
  ?>
  
  

• Пример ответа сервера при отправке текста на несколько номеров (развернуть)...

  <?xml version="1.0" encoding="UTF-8"?>
  <output>
  <xml_result action="http_post_sendviber" err="">
  	<result viber_group_id="XX-XXXX-XX">
  	<viber viber_id="XXXXXXXXXXX" err="" number="7XXXXXXXXXX" parts="количество частей из которых состоит текст сообщения"><![CDATA[текст отправленного сообщения...]]></viber>
  	<viber viber_id="XXXXXXXXXXX" err="" number="7XXXXXXXXXX" parts="количество частей из которых состоит текст сообщения"><![CDATA[текст отправленного сообщения...]]></viber>
  	…
  	</result>
  </xml_result>
  </output>
  
  *err=""	- номер ошибки, возникшей при отправке, если ошибки нет, то err=null либо err="0"
  (может быть как для всего пакета сообщений - ошибка обработки самого запроса, так и для одного конкретного номера - ошибка номера, направления и т.д.)