смс сервис
сервисы
Смс агрегатор
 
Пример скрипта обработчика Протокол обмена данными с API (услуга СМС БИЛЛИНГ)
версия 1.9, редакция: 07.11.2014

Техническая документация: Web API

 

Обращение к динамическому обработчику осуществляется посредством отправки HTTP запроса методом POST.


Платформа PAYY передает обработчику следующие параметры:
Переменная Описание переменной Тип Пример значения
 phone  Мобильный номер Абонента string 79201234567
 message  Сообщение, отправленное Абонентом (без префикса) string Текст сообщения
 country  Код страны integer 1234
 operator  Название Оператора integer 4567
 number  Короткий смс-номер, на который отправлено SMS integer 7890
 pay  Доход Партнера (отчисления в валюте страны) float 100.50
 payment  Доход Партнера (отчисления в рублях) float 38.270
 offtax  Стоимость смс-сообщения без налогов float 122.73
 ontax  Стоимость смс-сообщения с налогами float 135.00
 tax  Размер налога в стране float 10.00
 currency  Валюта страны string EUR
 unique  Уникальный ID SMS integer 1234
 hash  Дайджест запроса string d2c12fd82ddaa2da1e675c70228d33a1

 

Дополнительная справочная информация:

Коды (ID) и валюты стран

Коды (ID) и валюты стран Коды (ID) и валюты стран
Коды (ID) операторов Коды (ID) операторов Коды (ID) операторов

 




Ответ должен быть Content-Type text/plain и кодировке utf-8:
Код: пример обработчика на языке PHP
1
2
3
4
5
6
<?php

 header("Content-Type: text/plain; charset=utf-8");
 exit('Благодарим за участие! Ваш код: 1234');

 ?>


Стандартная длина одного смс-сообщения составляет 159 латинских символов или 69 кириллических (юникод) символов.
В случае превышения ограничения, по длине, одного смс-сообщения, сообщение считается составным и оплачивается каждая его часть, при этом с каждой стороны длина смс-сообщения уменьшается на 3 символа (для «склейки» смс-сообщения). Составные ответные смс-сообщения оплачиваются дополнительно за каждую часть.

Дайджест запроса рассчитывается из параметров запроса, которые задаются в строго указанном порядке:
md5 = unique + country + operator + number + phone + message + secret_key

полученный результат посылается для проверки целостности в параметре hash.


Пример обработчика с использованием секретного кода и проверкой целостности запроса:
Код: обработчик с использованием секретного кода и проверкой целостности запроса
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<?php

if(isset($_POST['unique'], $_POST['country'], $_POST['operator'], $_POST['number'], $_POST['phone'], $_POST['message'], $_POST['hash']))
{

$number = array("1234", "5678");

if(!in_array($_POST['number'], $number))
{
exit('Сообщение отправлено на неправильный номер');
}

$secret_key = '6dfgmEW98vmWEbdfe3';

$md5 = md5($_POST['unique'].$_POST['country'].$_POST['operator'].$_POST['number'].$_POST['phone'].$_POST['message'].$secret_key);

if(strcasecmp($md5, $_POST['hash']) == 0)
{
header("Content-Type: text/plain; charset=utf-8");
exit('Благодарим за участие! Ваш код: 1234'); 
}
} 

?>

Любой ответ со статусом 200 считается успешным; ответ направляется абоненту. Система поддерживает повторную отправку запроса в случае, если при его передаче произошло одно из следующих событий:

  • Время ожидания ответа от внешнего сервера истекло. Максимальное время ожидания ответа 20 секунд;
  • Web-сервером возвращен код ошибки, т.е. любой код, отличный от 200;
  • Ответ был некорректным: отсутствовал текст ответного сообщения.

 

При формировании ответного смс-сообщения рекомендуется не использовать специальные символы, они могут влиять на обрезку сообщения или некорректное отображение.

Вверх


Агрегатор трафика PAYY
© 2007-2017 Агрегатор трафика PAYY. HotLog Рейтинг@Mail.ru