смс:ключ

смс:ключ с удаленным размещением

Не уверены, какую услугу выбрать? Обратитесь к странице сравнения наших услуг!

Также обратите внимание на готовые скрипты.

Техническое описание

В стандартной версии смс:ключа всю работу по выдаче и отслеживанию паролей выполняет наш сервер, упрощая таким образом установку и настройку услуги, но одновременно лишая ее некоторой гибкости. Учитывая популярность услуги смс:ключ среди наших клиентов, мы решили пересмотреть некоторые аспекты ее использования. Так появилась версия с удаленным размещением, преимущества которой перед стандартным смс:ключом таковы:
- все пароли хранятся и обрабатываются на вашей стороне, давая таким образом возможность локально управлять сессиями пользователей;
- вы можете управлять как внешним видом, так и в определенных пределах принципом работы услуги;
- услуга максимально устойчива к разного рода атакам на наши сервера, перебоям работы сети и т. д.
- возможность передачи дополнительного параметра в тексте смс, с помощью которого можно идентифицировать, к какому именно разделу сайта был оплачен доступ (удобно в случае, если Вы хотите использовать один и тот же ключ для доступа к разным разделам или файлам, но хотите, чтобы пользователь оплачивал отдельно каждый раздел или файл).

 

Внимание: для использования этой версии ключа категорически необходимо понимание общих принципов работы скриптов, исполняемых на стороне сервера, знание PHP, HTML и навыки работы с базами данных. Поддержка по вопросам, связанным с установкой/настройкой скрипта, не предоставляется.

Детали реализации

Обработчик сообщений (Result URL) принимает следующие параметры:

Параметр Тип Описание
country char(2) Двухбуквенный код страны
provider char(16) Оператор сотовой связи
key int Идентификатор вашей услуги смс:ключ
pair char(10) Сгенерированный нашим сервером пароль
timeout int Время жизни сгенерированного пароля (pair) в минутах
limit int Количество активаций сгенерированного пароля
content char(128) Текст сообщения, следующий за идентификатором вашего сервиса
cost_local float Стоимость смс-сообщения в локальной валюте
sign_v4 char(32) MD5-хэш строки, состоящей из соединенных через двойное двоеточие ("::") параметров secret_code, key, pair, timeout, limit, content, country, cost_local, provider (в указанном порядке), где secret_code - секретный ключ Вашей услуги смс:ключ

Требования к системе:

PHP >= 4.3

Поддерживаемые СУБД:

MySQL - требует установленного модуля MySQL
SQLite - требует установленного модуля SQLite
PDO:SQLite (объектно-ориентированная версия) - требует установки модулей PDO и SQlite (обычно установлены на PHP >= 5.1)

Процесс установки:

1. распаковать файлы
2. изменить /lib/config.php
3. выставить права на запись на /lib/keys_db
4. выставить права на запись на /lib/local.xml
5. запустить setup.php и удалить его
6. запустить cron.php
7. настроить свой скрипт в соответствии с примером в check.php (после чего его можно удалить)
8. настроить сам ключ в панели управления, указав полный путь к result.php и секретный пароль из конфига

Комплектация:

/lib/config.php - конфигурационный файл, содержащий также базовые функции
/lib/keys_db - сама база
/lib/local.xml XML файл со всеми тарифами
/check.php - пример содержащий необходимый код для показа и проверки паролей
/cron.php - файл отвечает за обновление /lib/local.xml , можно запускать как вручную, так и используя CRON
/result.php - файл отвечает за прием паролей с нашего сервера
/select.php - файл просмотра списка паролей, логин и пароль к нему указываются в /lib/config.php
/setup.php - создает необходимые таблицы в базе

Обратите внимание:

1. Одна база может быть использована для целого ряда ключей;
2. При обновлении XML файла, если наш сервер недоступен, файл не обновляется и используется текущая копия. Учитывая, что тарифы меняются редко, это не будет иметь влияния на работу сайта;
3. result.php обязательно должен возвращать HTTP статус 200 OK и слово "OK" в теле ответа.

Примеры реализации

Исходный код скрипта находится здесь.

Примеры кода для генерации пользовательской инструкции по тарифной сетке в форматах XML и JSON можно скачать здесь.

Тарифная сетка — важный элемент работы с данной версией ключа. Сетка генерируется по настройкам вашей конкретной услуги и всегда доступна в форматах XML и JSON по адресам вида:

http://key.smscoin.com/xml2/key/идентификатор ключа/

http://key.smscoin.com/json/key/идентификатор ключа/

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

Для того, чтобы сообщение было корректно проассоциировано с вашим сервисом, оно должно иметь следующий вид:

префикс идентификатор ключа произвольный текст

Отправлено оно должно быть на правильный номер, действующий в стране отправителя и соответствующий, установленной вами цене смс-сообщения. Если какая-либо страна не фигурирует в тарифной сетке для вашей услуги, это значит, что в данной стране отсутствует выбранный вами при настройке тариф и отправить смс-сообщение этой стоимости из нее нельзя.

Полный перечень параметров находится на странице Тарифные сетки

Share |

Свяжитесь с нами

Техническая поддержка

E-mail: supportsmscoin.com

Общая поддержка

E-mail: helpsmscoin.com

Телефоны и факс >>