| МАСТЕР (ПЕРСОНАЛЬНЫЙ URL-САЙТ) ЧТО ТАКОЕ МАСТЕР
Услуга Мастер (персональный URL-САЙТ, далее сайт) является расширением услуги SMS-мастер и позволяет обращаться к ресурсам разработчика с сотового телефона по HTTP-интерфейсу. Наличие команды SETTEXT совместно с EMS-поддержкой позволяет создавать публичные библиотеки картинок, мелодий, анимаций непосредственно с телефона, без наличия собственных интернет ресурсов. Кроме того, эта команда позволяет создавать публичные MMS-библиотеки.
КЛАССИФИКАЦИЯ УЧАСТНИКОВ
| Участник | Описание | | Босс | Создатель сайта или получивший права от предыдущего создателя. | | Пользователь | Пользователь. Для каждого пользователя сайта ведется счет (ACCOUNT). Обращение к сайту увеличивает счет на 10, а посылка сообщения от сайта к пользователю уменьшает его на единицу. Сайт имеет механизм, который позволяет при обращении одного пользователя посылать ответ не только ему, но и другим пользователям, у которых счет положителен. Такой механизм позволяет легко реализовывать услуги класса Тематики, чатов и новостей. |
СТАТУСЫ САЙТОВ
| Статус | Описание | | PRIVATE | Приватный сайт. Не участвует в рейтинге по числу подписчиков. Слово PRIVATE в статусе не указывается (умолчание). | | PUBLIC | Публичный сайт. Участвует в рейтинге. | | MMS | Сайт поддерживает MMS-обращение. Если статус не установлен MMS-обращения также поддерживаются, но при обращении к сайту MMS данные не передаются. Умолчание - сайт MMS не поддерживает. | | DOC | Сайт с документацией. | | OPENSOURCE | Сайт с исходными текстами. |
КОМАНДЫ ПОЛЬЗОВАТЕЛЯ
| Команда | Описание | | MASTER Имя [Текст] | Обращение к сайту. | | MASTER Имя ACCOUNT | Увеличение счета пользователя на N и информирование его об этом счете. | | MASTER Имя INFO | Получение информации о сайте. | | MASTER Имя GETDDOC EMAIL | Получение документации на указанный EMAIL-адрес. Только для сайтов со статусом DOC. | | MASTER Имя GETSOURCE EMAIL | Получение исходных текстов сайта. Только для сайтов со статусом OPENSOURCE. | | RATM | Рейтинг сайтов |
КОМАНДЫ БОССА
| Команда | Описание | | MASTER Имя CREATE | Создание сайта. Имя сайта может состоять только из букв и цифр и не должно превышать 16 символов. | | MASTER Имя RENAME НовоеИмяСайта | Переименование сайта. | | MASTER PULLME EMAIL | Получение на указанный адрес письма, ответы на которые действуют как команды, набранные с телефона (командное письмо). Данный механизм делает БЕСПЛАТНЫМ управление сайтом для босса. Кроме того, некоторые команды можно выполнить только через командное письмо. | | MASTER Имя -PIDpid1,pid2… Текст | Посылка указанного текста, указанным пользователям сайта. | | MASTER Имя SETTEXT Текст | Установка текста, который будет выдаваться при обращении MASTER Имя. Команда позволяет создавать собственные сайты без наличия интернет ресурсов непосредственно с телефона. | | MASTER Имя SETURL URL | Установка ссылки на url-ресурс. | | MASTER Имя DELETEMYSITENOW | Удаление сайта. | | MASTER Имя DESCR Текст | Установка описания сайта. Выдается при просмотре INFO. Возможен поиск по описаниям, командой GETSITE. | | MASTER Имя MMS | Установка статуса поддержки MMS сайтом. Если поддержка установлена, то при обращении к сайту по MMS в запросе передается MMS данные (POST-запрос к сайту). Если поддержка не установлена, то передается только текстовая часть без MMS-данных (GET-запрос к сайту). Статус поддержки MMS сайтом должен быть явно установлен. По умолчанию считается, что сайт не поддерживает MMS. | | MASTER Имя NOMMS | Снятие статуса поддержки MMS сайтом. | | MASTER Имя PRIVATE | Приватный статус сайта. Рейтинг отключен. Данный статус является умалчиваемым при создании сайта. | | MASTER Имя PUBLIC | Установка публичного статуса сайта. Публичные сайты участвуют в рейтинге. | | MASTER PULLME -c | Блокировка письма посылки команд, если оно попало в недружелюбные руки. | | MASTER Имя LOG EMail [Дата] | Получение журнала работы сайта. Если дата не указана, то за сегодня. | | MASTER Имя STAT EMAIL [Дата] | Получение статистической информации обращения пользователей к сайту. Сейчас только за конкретное число, выдаются количество хитов и хостов. | | MASTER Имя PID EMAIL | Получение списка идентификаторов пользователей с положительными ACCOUNT и самими ACCOUNT. | | MYMASTER | Получение списка имен сайтов, боссом которых Вы являетесь. |
МНОГОСТРАНИЧНЫЙ САЙТ
Сайт может содержать много ссылок на разные URL-ресурсы. Ресурс, устанавливаемый командой MASTER Имя SETURL URL является главным (main) ресурсом, к которому обращается пользователь по команде MASTER ИмяСайта [Текст]. Дополнительные ресурсы, для ссылки из главного ресурса или других ресурсов устанавливается при помощи:
| Команда | Описание | | MASTER Имя.ИдРесурса SETTEXT Текст | Установка дополнительного ресурса (текст) в сайт. ИдРесурса должен состоять из букв-цифр. Его длина не должна превышать 16 символов | | MASTER Имя.ИдРесурса SETURL URL | Установка дополнительного ресурса в сайт. ИдРесурса должен состоять из букв-цифр. Его длина не должна превышать 16 символов |
Пользователь также может обратиться к дополнительному ресурсу (при его знании) по команде:
MASTER Имя.ИдРесурса [Текст] ПРЕОБРАЗОВАНИЕ ТЕКСТА ПОЛЬЗОВАТЕЛЯ В URL (ПОДСТАНОВКИ)
Текст, вводимый пользователем при обращении к сайту, может быть передан в параметры URL при помощи подстановок. Подстановка имеет синтаксис %Имя%
| Подстановка | Описание | | %*% | Весь текст, в том виде, как введен пользователем. | | %voc% | Текст, введенный пользователем с преобразованием на русский язык. В процесс преобразования включена словарная замена сокращений. |
Кроме подстановок, относящихся к введенному тексту, существуют подстановки, характеризующие пользователя, который обратился к сайту.
| Подстановка | Описание | | %pid% | Идентификатор пользователя. Идентификатор пользователя состоит из латинских букв и цифр и однозначно характеризует пользователя. Номер телефона из идентификатора не восстанавливается. | | %region% | Название региона расположения пользователя на базе префиксов номеров телефона. | | %account% | Текущий счет пользователя. | | %nick% | Прозвище (ник) пользователя. Расширяется в пусто, если прозвища нет. |
MMS ОБРАЩЕНИЕ К САЙТУ
Возможно MMS обращение к сайту. Для этого необходимо вместо отправки SMS на номер 684 отправить MMS на номер 684. В MMS-сообщении должна присутствовать текстовая часть (MASTER Имя Текст), а также могут присутствовать разнообразные MMS данные (картинки и/или мелодии). Если сайт имеет статус MMS и MMS данные в запросе присутствуют, то к сайту будет сформирован POST запрос, содержащий эти данные. Если сайт статуса MMS не имеет, то MMS данные не будут переданы сайту, а вид запрос будет аналогичен обыкновенному SMS запросу (GET-запрос). GET будет применен и в случае обращения к сайту по MMS, но без MMS данных.
Возвращаемые данные при POST-запросе к сайту должны быть такого же формата, как и при GET-запросе, т.е text/plain. Если сайт хочет вернуть MMS-контент, то он должен сделать это при помощи ems-нотации (<ems:mms...>)
Общая схема выбора транспорта ответа во всех 684-услугах такова. Если запрос к услуге был сделан по MMS-транспорту, то и ответ будет по MMS-транспорту. Если по SMS, то и ответ по SMS. MMS-контент (теги <ems:mms...>) при MMS-ответе будет передан на телефон сразу. MMS-контент при SMS-ответе (теги <ems:mms...>) будет преобразован к буквам загрузки (<БУКВЫ>!), и пользователь сможет получить контент, просто отправив эти БУКВЫ на 684.
Кроме того, ответ состоящий только из тега <ems:mms...> всегда передается по MMS-транспорту независимо от вида запроса.
ФОРМАТ ЗАПРОСА К САЙТУ ПРИ НАЛИЧИИ MMS ДАННЫХ В ЗАПРОСЕ
MMS запрос с данными к сайту со статусом MMS делается POST-запросом с
Content-Type: multipart/form-data
Рассмотрим последовательность команд:
MASTER MMS CREATE
MASTER MMS SET URL http://domain/path?text=%*%&voc=%voc%&pid=%pid%
MMS обращение к данному сайту с фотографией вида:
MASTER MMS Test + ФОТО
Приведет к формированию запроса вида:
POST /path HTTP/1.0
Date: дата запроса
Host: сервер, осуществляющий запрос
User-Agent: MASTER-MMS
Content-Type: multipart/form-data; boundary="--MMSPART--"
Content-Length: ДлинаТелаЗапроса
----MMSPART--
Content-Disposition: form-data; name="text"
Content-Type: text/plain; charset="windows-1251"
Content-Transfer-Encoding: base64
Test <ems:mms url="mms_0"> (в кодировке 1251, закодированное механизмом BASE64)
----MMSPART--
Content-Disposition: form-data; name="voc"
Content-Type: text/plain; charset="windows-1251"
Content-Transfer-Encoding: base64
Тест <ems:mms url="mms_0"> (в кодировке 1251, закодированное механизмом BASE64)
----MMSPART--
Content-Disposition: form-data; name="pid"
Content-Type: text/plain; charset="windows-1251"
Content-Transfer-Encoding: base64
BASE64 закодированный идентификатор телефона в кодировке 1251
----MMSPART--
Content-Disposition: form-data; name="mms_0"; filename="mms_0"
Content-Type: image/jpeg
Content-Transfer-Encoding: base64
BASE64 закодированные данные ФОТО в формате image/jpeg
----MMSPART----
В приведенном примере следует обратить внимание на конструкцию <ems:mms url="mms_0"> внутри параметров text (полный текст запроса) и voc (текст запроса, преобразованный в русский язык). Данная конструкция описывает размещение MMS-элемента внутри текста запроса. Сам MMS-элемент находится в одном из разделов запроса и имеет name=mms_0 и filename=mms_0.
ТРЕБОВАНИЯ К ФОРМАТУ ВОЗВРАЩАЕМЫХ ДАННЫХ ПРИ ОБРАЩЕНИИ К URL САЙТА
Аналогично услуге SMS-мастер, данные должны возвращаться в text/plain формате. Каждая строка передается на телефон, обратившегося к сайту отдельным сообщением до исчерпания его счета.
Кроме того, вводится расширение, позволяющее посылать сообщения не только тому, кто обратился к услуге, но и другим пользователям. Данное расширение расположено за строками передаваемыми инициатору и начинается со строки:
$PID
Данная строка может быть ПЕРВОЙ в возвращаемых данных, т.е текст инициатору может отсутствовать. За указанной строкой должна находиться одна или несколько строк, имеющих формат:
PIDПользователя Текст
Указанный текст, будет передан пользователю сайта с идентификатором PIDПользователя, если его счет положителен. Пользователь может включать и выключать возможность посылки сообщений со стороны сайта (умолчание ON).
| Команда | Описание | | MASTER Имя ON | Разрешение получения сообщения от сайта. | | MASTER Имя OFF | Блокировка получения сообщений от сайта. |
Обращаем внимание, что формат возвращаемых данных не отличается для запросов, сделанных по SMS и запросов, сделанных по MMS. Вид транспорта, по которому будут переданы возвращаемые данные пользователю будет выбран самой услугой в зависимости, как от вида обращения к услуге, так и настроек пользователя.
ИСПОЛЬЗОВАНИЕ EMS В ТЕКСТЕ ЗАПРОСА
Сообщения с EMS-элементами передаются через подстановки %*% %voc% в EMS-нотации. Более подробно о EMS-нотации можно узнать, послав письмо с темой: _BOOK EMS по адресу [email protected].
ИСПОЛЬЗОВАНИЕ EMS В ТЕКСТЕ ВЫДАВАЕМЫХ СООБЩЕНИЙ
Допускается. Это позволяет создавать библиотеки картинок, логотипов, мелодий, MMS-документов и документов, высылаемых по почте без всякого программирования. В конце данного документа даны рекомендации по созданию таких библиотек.
EMS-нотация позволяет описывать сообщения с MMS-контентом. Такое описание следует использовать при желании вернуть на телефон MMS-контент.
Если используется MMS-транспорт при ответе (запрос к сайту был сделан по MMS), то элементы в EMS-нотации будут преобразованы к MMS-формату.
ИСПОЛЬЗОВАНИЕ КОМАНД В ТЕКСТЕ ВЫДАВАЕМЫХ СООБЩЕНИЙ
В тексте сообщений, можно указывать ограниченное подмножество 684-команд, которые будут преобразованы и выведены в виде БУКВ (закодированы). Обратная посылка БУКВ на 684 приведет к раскодировке и выполнению соответствующей закодированной команды. Недопустимая команда будет закодирована в команду, посылающую текст о ее недопустимости боссу сайта.
Для этого команда должна быть оформлена в виде блока:
<ENCODE>Команда</ENCODE>
К примеру, ссылки на другую страницу сайта могут быть закодированы как:
<ENCODE>MASTER Имя.ИдентификаторСтраницы</ENCODE>
К допустимым командам относятся (может быть расширено, по просьбам пользователей):
| Команда | Описание | | MASTER Имя … | Обращение к собственному или другим сайтам. | | URL, URLVOC | Обращение при помощи SMS-мастера. |
Для совместимости с услугой "SMS-Мастер" добавлена также поддержка блока:
<Команда:Параметры>
Допустимые команды - URL, URLVOC - Обращение при помощи SMS-мастера
ПОЧТОВЫЙ ИНТЕРФЕЙС
Почтовый интерфейс дает боссу возможность выполнять команды своего сайта через Интернет, а не с телефона, делая, тем самым, их выполнение бесплатным. Кроме того, ряд команд возможно выполнить только через почтовый интерфейс. Для получения командного письма, надо послать SMS вида:
MASTER PULLME Email
В ответ, на указанный Email адрес придет командное письмо, в ответах на которое, можно писать команды, вместо набора таких команд на телефоне.
Командное письмо - это обычное письмо с информацией (волшебным словом), ответ на которое трактуется специальным образом, а именно: Текст сообщения до первой пустой строки считается текстом, набранным на клавиатуре телефона и посланным на номер 684. В посланном письме должно содержаться волшебное слово, проще всего это можно достичь ответом с полным цитированием, поэтому и используется слово ответ. Просто обратите внимание, что сообщение, посылаемое на 684, находится в начале письма-ответа.
Командное письмо действует на все сайты, в которых владелец письма является боссом.
Командное письмо действительно в течении 100 дней (100 дней ответы на это письмо будут работать). Командное письмо на следующие 100 дней можно получить через предыдущее командное письмо, послав: MASTER PULLME Email. Для каждого телефона может быть использовано только одно командное письмо, т.е. получение нового письма отключает старое.
Командное письмо заменяет клавиатуру, сообщения от услуги приходят на телефон. Поэтому его можно использовать только совместно с телефоном.
ВИД КОМАНДНОГО ПИСЬМА
--- волшебное слово
СОБСТВЕННО_ВОЛШЕБНОЕ_СЛОВО
За MASTER-командой ДОЛЖНА БЫТЬ пустая строка. Ответ ДОЛЖЕН СОДЕРЖАТЬ текст данного письма. Работает до ДАТА_ПОСЛЕДНЕГО_ДНЯ_РАБОТЫ.
Более подробную информацию можно получить, отправив письмо с темой _BOOK MASTER по адресу [email protected]
Самым существенным элементом письма является волшебное слово. Оно имеет вид:
(~СИМВОЛЫ)
Его наличие ОБЯЗАТЕЛЬНО в ответе.
ПРИМЕР ОТВЕТА НА КОМАНДНОЕ ПИСЬМО (МИНИМАЛЬНЫЕ ТРЕБОВАНИЯ)
MASTER BEERBIBIREVO SETURL http://beerbibirevo.com/menu.php
(~СИМВОЛЫ)
Наиболее простым вариантом посылки команды является ответ на командное письмо, с сохранением текста самого командного письма. Команда ДОЛЖНА быть в начале ответа. За командой ДОЛЖНА быть пустая строка.
КОМАНДЫ, ДОПУСТИМЫЕ ТОЛЬКО ЧЕРЕЗ ПОЧТОВЫЙ ИНТЕРФЕЙС
| Команда | Описание | | MASTER Имя SETDOC | Установка документации. Командное письмо должно содержать документацию в ATTACHе.(один или несколько) Сайт получит статус DOC. Для удаление документации следует выполнить указанную команду без ATTACH. | | MASTER Имя SETSOURCE | Установка исходных текстов. Исходные тексты должны содержаться в ATTACHе (один или несколько). Сайт получит статус OPENSOURCE. Для удаления исходных текстов следует выполнить указанную команду без ATTACH. |
ПЕРЕДАЧА САЙТА НОВОМУ ВЛАДЕЛЬЦУ
Существует 2 возможности передачи сайта новому владельцу - передача по номеру телефона и парольная передача. Первый вариант - это передача другому. Второй вариант предназначен, в основном, для передачи канала самому себе при смене номера телефона (сим-карты).
| Команда | Описание | | MASTER Имя SETBOSS НомерТелефона | Передача сайта указанному боссу. | | MASTER Имя GETPASSWORD | Получение пароля. | | MASTER Имя IAMBOSS Пароль | Парольное назначения себя боссом (при знании пароля). | | MASTER Имя SETPASSWORD Пароль | Установка пароля. |
СОЗДАНИЕ ПРОСТЕЙШИХ СТАТИЧЕСКИХ (БЕЗ ПРОГРАММИРОВАНИЯ) САЙТОВ
Ниже приведен текст письма, в котором содержатся рекомендации по созданию статического сайта - библиотеки EMS-картинок. По этим рекомендациям создан сайт, использование которого описано здесь:
http://www.gsm-land.narod.ru/EMS/emsscreen.html.
Данная библиотека содержит картинки размером 72*28 и может быть использована для NOKIA, SAMSUNG и SIEMENS телефонов. Если у Вас NOKIA или SAMSUNG, то позвоните по номеру 068499202 или отправьте SMS на 684: SYM EMS-CLASS NOKIA. Если у Вас SIEMENS, то позвоните по номеру 068499204 или отправьте SMS на 684: SYM EMS-CLASS SIEMENS-EMS. Наконец, если у Вас SIEMENS без поддержки EMS, то то позвоните по номеру 068499203 или отправьте SMS на 684: SYM EMS-CLASS SIEMENS.
Добрый вечер! EMS-библиотеку можно сделать при помощи Мастера, при этом НЕ ТРЕБУЕТСЯ НИКАКОГО ПРОГРАММИРОВАНИЯ.
Последовательность действий:
1. Запишите каждый EMS-элемент библиотеки в отдельный файл с расширением .txt. Файл должен состоять из ОДНОЙ строки, в которой должен быть EMS-элемент. Перепишите полученные файлы на сервер и проверьте доступ к ним по HTTP-запросу, скажем http:://ДОМЕН/.../имяФайла.txt.
IE должен показывать эти файлы, как текстовую строку.
2. Создайте персональный сайт (предположим BUKA).
MASTER BUKA CREATE
3. Для каждого файла с EMS-элементами выполните команду:
MASTER BUKA.НекоеИмя SETURL URLФайла
скажем:
MASTER BUKA.PORNO SETURL http:://ДОМЕН/.../имяФайла.txt
Тогда при посылке на 684:
MASTER BUKA.PORNO
на телефон будет посылаться элемент, описанный в файле http:://ДОМЕН/…/имяФайла.txt
Таким образом, Вы можете создать целую библиотеку картинок с произвольными именами этих самых картинок внутри Вашего сайта и рассказать всем об этих именах. Можете использовать вместо имен номера:
MASTER BUKA.1 SETURL http:://ДОМЕН/.../имяФайла1.txt
MASTER BUKA.2 SETURL http:://ДОМЕН/.../имяФайла2.txt
СОЗДАНИЕ САЙТОВ С ТЕЛЕФОНА
Появление команды SETTEXT позволяет создавать библиотеки картинок и мелодий непосредственно с телефона. Для этого:
1. Создайте сайт (к примеру GIPPOPOTAM для размещения картинок про гиппопотамов).
MASTER CREATE GIPPOPOTAM
2. Напишите кратную инструкцию по использованию сайта при обращении MASTER GIPPOPOTAM.
MASTER GIPPOPOTAM SETTEXT Картинки гиппопотамов для NOKIA. 17 - штук. Для получения отправьте MASTER GIPPOPOTAM.Номер (Номер=1..17)
3. И теперь выполните 17 команд определения GIPPOPOTAM.Номер. При отправке присоединяйте соответстующие картинки.
MASTER GIPPOPOTAM.1 SETTEXT Вид сзади КАРТИНКА
САЙТЫ С MMS-КОНТЕНТОМ
Совершенно аналогично, можно создавать сайты с MMS-контентом, как при наличии своего ресурса в Интернет, так и прямо с телефона. При создании сайтов с MMS-контентом с телефона, следует просто использовать MMS-транспорт передачи данных к услуге, а именно посылать не SMS, а MMS сообщения.
ДЛЯ ПРОГРАММИСТОВ
Рассмотрим МАСТЕР-сайт с условным названием LOGO. Отправка с NOKIA и SAMSUNG телефонов SMS на 684 вида:
MASTER LOGO Текст
Приведет к получению телефоном логотипа оператора, который изображает текст.
К примеру, при посылке SMS на 684:
MASTER LOGO 25 у Васи день рождения
на телефон придет логотип оператора с указанным текстом. И тогда Васю точно не забудете поздравить :)
Описанный МАСТЕР-сайт не реализован и предлагается как идея. Функциональность такого сайта, на наш взгляд, будет востребована. Сама реализация достаточно проста.
Дата публикации: 22.05.2006
Прочитано: 50 раз
Дополнительно на данную тему
|
