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" уйдет смс сообщеием вашему клиенту.
							?>