API, передача данных

Информация для разработчиков

Для интеграции SMS-проекта Вы можете самостоятельно получать и разбирать данные приходящие по вашему смс-проекту в платформу Mvote. Или ставить готовый скрипт.

Способ № 1 - GET-запрос

Передача данных происходит через GET-запрос.

1. Нам нужен от вас адрес страницы, куда обращаться (URL) и «Секретное слово».
(При наличии доступа в наш личный кабинет, вы можете сами вписать эту информацию в настройках вашего SMS-проекта)

2. Мы передаем на вашу страницу запрос вида:
?date=xx&txt=xx&sid=xx&prefix=xx&tid=xx

(это пример, конкретную строчку с данными, которые у вас включены, вы видете в настройках вашего SMS-проекта)

- date = дата UNIX TimeStamp, запись всех данных ведется UTC 0, то есть, если конвертировать будет в сравнении с Россией - 3 часа.
- txt = текст смс
- sid = сгенерированный проверочный код
- prefix = префикс
- tid = уникальный номер смс

3. Генерация проверочного кода sid:
(секретный ключ).encode('utf-8') + ( текст смс).encode('utf-8') + (уникальный номер смс).encode('utf-8') + (дата).encode('utf-8')
Т.е. в создании проверочного sid используются все поля, которые выбраны для передачи вам запроса.

Запись (XXX).encode('utf-8') — значит кодировка значения в utf-8.
Знак "+" — это конкатенация строк.
«SID = md5(секретное слово . $txt . $phone . $tid . $data);»

Наше приложение отправляет запрос, если не получен ответ, то делается еще 2 попытки и останавливает передачу этого запроса.
Ваш ответ должен содержать слово «sms».

Это пример строки с данными
http://ваш-сайт.ru/ваш-скрипт.php/?date=1429184830&txt=это тест &sid=1f21b7e76da4042e122a2e954b52bbec&tid=1429184830.29067.03095

4. Транзит (передача текста абоненту)

В случае, когда ваш проект подразумевает уникальный ответ для абонента (например, код для регистрации), то после слова «sms», через пробел, вы указываете этот текст (по умолчанию отправляется текст в размере до 70 символов (с учетом пробелов) в кириллице).

- ответ вашего скрипта ожидается в течение 4-х секунд, после чего сессия закрывается, абоненту отправляется "заглушка" (пример, стандартный текст "Ваше сообщение принято").

В режиме работы вашего проекта "голосование" абоненту отправляются стандартные ответы системы по учету голосов, в зависимости от настроек проекта. Например: "Ваш голос учтен"; "Повторное голосование"; "Голосование закрыто."

Способ № 2 - JavaScrip

Готовое решение, платно

Также есть готовая к выводу страница HTML с исполняемым кодом JavaScript, которая автоматически отображает данные по вашему проекту на вашем сайте. Вам остается лишь адаптировать дизайн для лучшей визуализации. Состав автоматически передаваемых данных: заголовок проекта, текст варианта,  пришедшие SMS в % и/или количестве голосов.

Способ № 3 - «Без интеграции»

Готовое решение без интеграции, бесплатно

Для небольших проектов, где не требуется интеграция хода SMS-голосования на свой сайт, есть системный вывод оторажения online смс-голосования. Ограничения: в бесплатном режиме интерактивная статистика хода смс-голосования отображает до 18 имен конкурсантов (вариантов ответов).

В самом личном кабинете доступна статистика без ограничения (без автоматического обновления), но только для владельца аккаунта (после авторизации).

Навигация по сайту

1. Примеры SMS-голосования
2. SMS-голосование "под ключ"
3. Интерактивная система голосований (конференц-система)
4. Смс-диалог (SMS чат)- сервис для конференций и праздников
   
5. Аренда интерактивных пультов для голосования
6. Контакты
   
7. Аренда короткого номера для SMS
   
8. SMS-акции для продвижения (промо акции)
9. Наши Клиенты

Подписать на новости по RSS

Контакты:

+7 495 778-52-80

+7 903 788-78-08

Ежедневно с 9.00 до 21.00

mail@mvote.ru

whatsapp telegram