SMSFeedback API для обработки смс
на короткие номера на вашем сайте
Интерфейс прикладного программирования - Application programming interface (API) для интеграции с SMSfeedback
API использует GET запрос для передачи сообщения, которое абонент отправил на короткий номер с выбранным вами префиксом. Кроме самого текста сообщения, вашему скрипту будут переданы, другие данные, которые вы можете использовать для обработки "входных данных" у себя на сайте.
Передача сообщения
GET запрос на сервер, вида:
http://адрес_сервера/ваш_скрипт?num=2420&user_id=79876543210&msg=SLOVO+TEXT
Параметр | Описание |
---|---|
msg | Текст сообщения. Например, "SLOVO+TEXT", где ваш уникальный префикс - это "SLOVO", а "+TEXT" - данные которые добавил абонент. Максимум 134 символа. |
num | короткий номер на который отправлено сообщение, например, 1121 |
date | Дата обработки смс на короткий номер в формате 2008-01-01 17:01:53 |
user_id | Телефон с которого отпарвлено сообщение в формате 79031234567 |
smsid | Уникалтный идентификатор сообщения на короткий номер в формате 12345678910 |
secretkey | Уникалтный защитный ключ в формате df03ee1е7407dc7t50754041d730933f. Специальное согласованное с нами защитное слово, закодированное md5 алгоритмом кодирования совместно с другими параметрами в подпись sign для обеспечения безопасности вашего скрипта. |
msg_trans | транслитерация сообщения |
operator_id | числовой идентификатор оператора |
cost_rur | комиссия смс сервиса |
ran | параметр надежности абонентского номера - цифра от 1 до 10, которая показывает степень доверия и обеспеченности деньгами к абон. номеру. 1-4 - ненадежные, 5-7 - средние, 8-10 - надежные. В примере 7 |
test | необязательный параметр, приходит только при тестовой смс. Если он равен единице значит смс тестовая. |
country_id | идентификатор страны |
sign | это последовательность символов, которая кодируется по алгоритму MD5, передается всегда. Последовательность получается путем последовательного соединения параметров: date msg_trans operator_id user_id smsid cost_rur ran test num country_id secretkey |
После обработки "входных данных" ваш скрипт должен ответить HTTP статусом 200. В противном случае наша система будет пытаться доставить сообщение снова и снова, увеличивая интервал между попытками.
Пример скрипта обработчика на PHP
<?php /* использование функции передачи сообщения */ $smsid = $_GET['smsid']; // идентификатор смс сообщения $sign = $_GET['sign']; // контрольная подпись $secretkey = "wwe0843432sdfsdf"; // согласовывется со службой поддержки SMSfeedback if (md5($_GET['date'].$_GET['msg_trans'].$_GET['operator_id'].$_GET['user_id'].$_GET['smsid'].$_GET['cost_rur'].$_GET['ran'].$_GET['test'].$_GET['num'].$_GET['country_id'].$secretkey) != $sign) header("HTTP/1.0 404 Not Found"); // если коды не совпадают, прерываем обработку. // Формируем ответ echo "smsid:$smsid\n"; echo "status:reply\n"; echo "\n"; echo "Usluga oplachena. Поддержка: help.smsfeedback.ru\n"; // Текст "Usluga oplachena. Поддержка: help.smsfeedback.ru\n" уйдет смс сообщеием вашему клиенту. ?>