====== Различия ====== Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
|
ru:service1:start [2013/06/12 13:33] admin |
ru:service1:start [2020/08/21 14:16] (текущий) |
||
|---|---|---|---|
| Строка 5: | Строка 5: | ||
| Услуга **смс:ключ** является простым способом ограничить доступ пользователя к содержимому того или иного сетевого ресурса, доступ к которому возможен только после ввода кода (пароля). Для того чтобы получить требуемый код доступа, пользователь отправляет Premium SMS на короткий номер и получает пароль в ответном сообщении. Владелец сайта, на котором находится контент, может задать параметры, определяющие, сколько раз и в течение какого времени этот код может быть использован. Легкость установки и гибкость настройки делают **смс:ключ** предпочтительным решением для большинства сайтов. | Услуга **смс:ключ** является простым способом ограничить доступ пользователя к содержимому того или иного сетевого ресурса, доступ к которому возможен только после ввода кода (пароля). Для того чтобы получить требуемый код доступа, пользователь отправляет Premium SMS на короткий номер и получает пароль в ответном сообщении. Владелец сайта, на котором находится контент, может задать параметры, определяющие, сколько раз и в течение какого времени этот код может быть использован. Легкость установки и гибкость настройки делают **смс:ключ** предпочтительным решением для большинства сайтов. | ||
| - | **Услуга модерируется.** | ||
| - | |||
| - | **смс:ключ** можно использовать для: | ||
| - | * продажи контента за SMS; | ||
| - | * ограничения доступа к любому полю на странице или разделу на сайте; | ||
| - | * организации регистрации за SMS или платного доступа к заполнению любой формы; | ||
| - | * создания платных файловых архивов; | ||
| - | * организации голосований и многих других целей. | ||
| Характерными особенностями **смс:ключа** являются: | Характерными особенностями **смс:ключа** являются: | ||
| Строка 31: | Строка 23: | ||
| * указание о дополнительных налогах и сборах, которые могут быть установлены в выбранной стране; | * указание о дополнительных налогах и сборах, которые могут быть установлены в выбранной стране; | ||
| * дополнительная информация: правила составления текста SMS, условия ответственности, информация о технической поддержке и пр. | * дополнительная информация: правила составления текста SMS, условия ответственности, информация о технической поддержке и пр. | ||
| - | - Отправленное пользователем SMS-сообщение через оператора (и агрегатора) поступает на наш сервер. | + | - Отправленное пользователем SMS-сообщение через оператора поступает на наш сервер. |
| - Согласно тексту SMS определяется соответствующий **смс:ключ** и проверяется: | - Согласно тексту SMS определяется соответствующий **смс:ключ** и проверяется: | ||
| * статус оплаты принятого оператором сотовой связи сообщения; | * статус оплаты принятого оператором сотовой связи сообщения; | ||
| - | * соответствие стоимости принятого SMS-сообщения и стоимости, установленной в настройках **смс:ключа** - она не должна быть оплачена по меньшему тарифу (при этом по большему допускается). | + | * соответствие стоимости принятого SMS-сообщения и стоимости, установленной в настройках **смс:ключа** |
| - Если проверка прошла успешно, на нашем сервере генерируется и фиксируется в базе данных уникальный, в пределах данного **смс:ключа**, код доступа. При этом также фиксируются следующие параметры: | - Если проверка прошла успешно, на нашем сервере генерируется и фиксируется в базе данных уникальный, в пределах данного **смс:ключа**, код доступа. При этом также фиксируются следующие параметры: | ||
| * Access limit - количество раз, которое можно использовать код, установленное в настройках **смс:ключа** на момент генерации кода; | * Access limit - количество раз, которое можно использовать код, установленное в настройках **смс:ключа** на момент генерации кода; | ||
| Строка 40: | Строка 32: | ||
| * Timeout - срок действия кода в минутах с момента его первого использования (ввода на сайт), установленный в настройках **смс:ключа** на момент генерации кода; | * Timeout - срок действия кода в минутах с момента его первого использования (ввода на сайт), установленный в настройках **смс:ключа** на момент генерации кода; | ||
| * Created - дата и время генерации кода доступа. | * Created - дата и время генерации кода доступа. | ||
| - | - Сгенерированный код передается оператору сотовой связи (через агрегатора), который передает его пользователю в виде ответного сообщения. | + | - Сгенерированный код передается оператору сотовой связи, который передает его пользователю в виде ответного сообщения. |
| - Если используется [[#Смс:ключ с удаленным обработчиком|смс:ключ с удаленным обработчиком]], то наш сервер с помощью HTTP-запроса вызывает обработчик по URL-адресу, указанному в настройках **смс:ключа** в поле **Result URL**, и передает ему необходимые [[#Данные, передаваемые на обработчик|данные]], включая сгенерированный код. | - Если используется [[#Смс:ключ с удаленным обработчиком|смс:ключ с удаленным обработчиком]], то наш сервер с помощью HTTP-запроса вызывает обработчик по URL-адресу, указанному в настройках **смс:ключа** в поле **Result URL**, и передает ему необходимые [[#Данные, передаваемые на обработчик|данные]], включая сгенерированный код. | ||
| - Пользователь на сайте вводит код доступа, полученный в ответном SMS. | - Пользователь на сайте вводит код доступа, полученный в ответном SMS. | ||
| - Введенный код проверяется на корректность. При этом: | - Введенный код проверяется на корректность. При этом: | ||
| - | * в случае использования [[#Стандартная версия смс:ключа|стандартной версии смс:ключа]] (без удаленного обработчика) проверка осуществляется на нашем сервере; | + | * в случае использования [[#Стандартная версия смс:ключа|стандартной версии смс:ключа]] (без удаленного обработчика) проверка осуществляется на сервере smscoin; |
| * в случае использования [[#Смс:ключ с удаленным обработчиком|смс:ключа с удаленным обработчиком]] проверка осуществляется на сервере сетевого ресурса. | * в случае использования [[#Смс:ключ с удаленным обработчиком|смс:ключа с удаленным обработчиком]] проверка осуществляется на сервере сетевого ресурса. | ||
| - Если проверка прошла успешно, пользователю предоставляется доступ к оплаченному ресурсу. | - Если проверка прошла успешно, пользователю предоставляется доступ к оплаченному ресурсу. | ||
| Строка 88: | Строка 80: | ||
| Для установки стандартной версии **смс:ключа** необходимо скопировать клиентский код скрипта из Панели Управления и вставить его в самом начале страницы (без пробелов и пустых строк!), содержимое которой планируется скрыть. Все, что находится ниже этого кода, будет доступно пользователю только после отправки SMS-сообщения и активации пароля, полученного в ответном SMS.\\ | Для установки стандартной версии **смс:ключа** необходимо скопировать клиентский код скрипта из Панели Управления и вставить его в самом начале страницы (без пробелов и пустых строк!), содержимое которой планируется скрыть. Все, что находится ниже этого кода, будет доступно пользователю только после отправки SMS-сообщения и активации пароля, полученного в ответном SMS.\\ | ||
| - | Ниже подробно рассматривается PHP-версия скрипта. Версии скрипта на других языках программирования можно посмотреть непосредственно в [[http://smscoin.com/keys/|Панели Управления]]. | ||
| Посмотреть на пример работы стандартной версии **смс:ключа** можно [[http://smscoin.com/demo/key/normal/|здесь]]. В случае, если в настройках сервиса вы указали, что ресурс "для взрослых", результат будет несколько отличаться, как показано [[http://smscoin.com/demo/key/adult/|здесь]]. | Посмотреть на пример работы стандартной версии **смс:ключа** можно [[http://smscoin.com/demo/key/normal/|здесь]]. В случае, если в настройках сервиса вы указали, что ресурс "для взрослых", результат будет несколько отличаться, как показано [[http://smscoin.com/demo/key/adult/|здесь]]. | ||
| Строка 131: | Строка 122: | ||
| Пример работы можно увидеть [[http://smscoin.com/demo/key/english/|здесь]]. | Пример работы можно увидеть [[http://smscoin.com/demo/key/english/|здесь]]. | ||
| - | |||
| - | **Для мобильных браузеров**\\ | ||
| - | Для посетителей WAP-сайтов, когда вместо HTML генерируется WML-разметка, нужно изменить в приведенном ниже коде адрес запроса | ||
| - | http://key.smscoin.com/key/ | ||
| - | на | ||
| - | http://key.smscoin.com/key_wml/ | ||
| - | Пример работы можно увидеть [[http://smscoin.com/demo/key/wml/|здесь]]. | ||
| **Порядок взаимодействия скрипта с нашей системой** | **Порядок взаимодействия скрипта с нашей системой** | ||
| Строка 338: | Строка 322: | ||
| |user_1\\ user_2\\ ...\\ user_n | |Не обязательный перечень параметров, определяемый пользователем,\\ который задается в строке **Адреса обработчика** в Панели Управления в настройках услуги.\\ Суммарное ограничение размера всех пар "поле-значение" составляет 155 символов.\\ \\ __**Внимание!**__\\ Пользовательские параметры не должны начинаться с префикса s_,\\ поскольку его использование зарезервировано для наших внутренних нужд. | | |user_1\\ user_2\\ ...\\ user_n | |Не обязательный перечень параметров, определяемый пользователем,\\ который задается в строке **Адреса обработчика** в Панели Управления в настройках услуги.\\ Суммарное ограничение размера всех пар "поле-значение" составляет 155 символов.\\ \\ __**Внимание!**__\\ Пользовательские параметры не должны начинаться с префикса s_,\\ поскольку его использование зарезервировано для наших внутренних нужд. | | ||
| - | ==== Лог вызова удаленного обработчика ==== | ||
| - | Существует возможность просмотра лога вызова удаленного обработчика по следующему адресу | ||
| - | http://helprpc.smscoin.com/smscoin/httplogs/key/идентификатор ключа/ | ||
| - | или, в общем случае: | ||
| - | http://helprpc.smscoin.com/smscoin/httplogs/key/идентификатор ключа/?limit=число | ||
| - | где <число> - количество показываемых последних записей (по умолчанию 30). | ||
| - | |||
| - | __**Внимание!**__ Категорически запрещено сообщать эти адреса клиентам ! | ||
| - | |||
| - | Более подробную информацию о логе вызова удаленного обработчика можно посмотреть в [[agregator:log|Справочнике]]. | ||
| ==== Типичный PHP-скрипт удаленного обработчика ==== | ==== Типичный PHP-скрипт удаленного обработчика ==== | ||
| Строка 418: | Строка 392: | ||
| или | или | ||
| http://key.smscoin.com/json/key/идентификатор ключа/ | http://key.smscoin.com/json/key/идентификатор ключа/ | ||
| - | Более подробную информацию по тарифным сеткам в форматах XML и JSON можно посмотреть в [[agregator:rates|Справочнике]]. | + | |
| ===== Примеры работы и готовые скрипты ===== | ===== Примеры работы и готовые скрипты ===== | ||