навигатор

                               mobile-nnov.narod.ru  // мастер

Мастер ( персональный URL-САЙТ)

02.10.2003 – изменения выделены цветом.
26.11.2003 – MMS-поддержка

Ваши замечания и вопросы присылайте по адресу help@beemail.ru Из наиболее часто задаваемых вопросов будет сформирован раздел FAQ данного документа. Для оперативного получения информации о модификации услуги подпишитесь на канал новостей MASTER. Для этого пошлите на 684 SMS: NEWS MASTER

Услуга Мастер (персональный URL-САЙТ, далее сайт) является расширением услуги SMS-мастер и позволяет обращаться к ресурсам разработчика с сотового телефона по HTTP-интерфейсу. Наличие команды SETTEXT совместно с EMS-поддержкой позволяет создавать публичные библиотеки картинок, мелодий, анимаций непосредственно с телефона, без наличия собственных интернет ресурсов. Кроме того, эта команда позволяет создавать публичные MMS-библиотеки.

Классификация участников:

Статусы сайтов:

Команды пользователя

Команды босса

Многостраничный сайт

Сайт может содержать много ссылок на разные URL-ресурсы. Ресурс, устанавливаемый командой MASTER Имя SETURL URL является главным (main) ресурсом, к которому обращается пользователь по команде MASTER ИмяСайта [Текст]. Дополнительные ресурсы, для ссылки из главного ресурса или других ресурсов устанавливается при помощи:

Пользователь также может обратиться к дополнительному ресурсу (при его знании) по команде:

Преобразование текста пользователя в URL (подстановки):

Текст, вводимый пользователем при обращении к сайту, может быть передан в параметры URL при помощи подстановок. Подстановка имеет синтаксис %Имя%

Кроме подстановок, относящихся к введенному тексту, существуют подстановки, характеризующие пользователя, который обратился к сайту.

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).

Обращаем внимание, что формат возвращаемых данных не отличается для запросов, сделанных по SMS и запросов, сделанных по MMS. Вид транспорта, по которому будут переданы возвращаемые данные пользователю будет выбран самой услугой в зависимости, как от вида обращения к услуге, так и настроек пользователя.

Использование EMS в тексте запроса.

Сообщения с EMS-элементами передаются через подстановки %*% %voc% в EMS-нотации. Более подробно о EMS-нотации можно узнать, послав письмо с темой: _BOOK EMS по адресу sms@beemail.ru.

Использование EMS в тексте выдаваемых сообщений.

Допускается. Это позволяет создавать библиотеки картинок, логотипов, мелодий, MMS-документов и документов, высылаемых по почте без всякого программирования. В конце данного документа даны рекомендации по созданию таких библиотек.

EMS-нотация позволяет описывать сообщения с MMS-контентом. Такое описание следует использовать при желании вернуть на телефон MMS-контент.

Если используется MMS-транспорт при ответе (запрос к сайту был сделан по MMS), то элементы в EMS-нотации будут преобразованы к MMS-формату.

Использование команд в тексте выдаваемых сообщений:

В тексте сообщений, можно указывать ограниченное подмножество 684-команд, которые будут преобразованы и выведены в виде БУКВ (закодированы). Обратная посылка БУКВ на 684 приведет к раскодировке и выполнению соответствующей закодированной команды. Недопустимая команда будет закодирована в команду, посылающую текст о ее недопустимости боссу сайта.

Для этого команда должна быть оформлена в виде блока:

<ENCODE>Команда</ENCODE>

К примеру, ссылки на другую страницу сайта могут быть закодированы как:

<ENCODE>MASTER Имя.ИдентификаторСтраницы</ENCODE>

К допустимым командам относятся (может быть расширено, по просьбам пользователей):

Для совместимости с услугой “SMS-Мастер” добавлена также поддержка блока:

<Команда:Параметры>

Допустимые команды - URL, URLVOC - Обращение при помощи SMS-мастера

Почтовый интерфейс

Почтовый интерфейс дает боссу возможность выполнять команды своего сайта через Интернет, а не с телефона, делая, тем самым, их выполнение бесплатным. Кроме того, ряд команд возможно выполнить только через почтовый интерфейс. Для получения командного письма, надо послать SMS вида:

MASTER PULLME Email

В ответ, на указанный Email адрес придет командное письмо, в ответах на которое, можно писать команды, вместо набора таких команд на телефоне.

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

Командное письмо действует на все сайты, в которых владелец письма является боссом.

Командное письмо действительно в течении 100 дней (100 дней ответы на это письмо будут работать). Командное письмо на следующие 100 дней можно получить через предыдущее командное письмо, послав: MASTER PULLME Email. Для каждого телефона может быть использовано только одно командное письмо, т.е. получение нового письма отключает старое.

Командное письмо заменяет клавиатуру, сообщения от услуги приходят на телефон. Поэтому его можно использовать только совместно с телефоном.

Вид командного письма

--- волшебное слово

СОБСТВЕННО_ВОЛШЕБНОЕ_СЛОВО

За MASTER-командой ДОЛЖНА БЫТЬ пустая строка. Ответ ДОЛЖЕН СОДЕРЖАТЬ текст данного письма. Работает до ДАТА_ПОСЛЕДНЕГО_ДНЯ_РАБОТЫ.

Более подробную информацию можно получить, отправив письмо с темой _BOOK MASTER по адресу sms@beemail.ru

Самым существенным элементом письма является волшебное слово. Оно имеет вид:

(~СИМВОЛЫ)

Его наличие ОБЯЗАТЕЛЬНО в ответе.

Пример ответа на командное письмо (минимальные требования)

MASTER BEERBIBIREVO SETURL http://beerbibirevo.com/menu.php

(~СИМВОЛЫ)

Наиболее простым вариантом посылки команды является ответ на командное письмо, с сохранением текста самого командного письма. Команда ДОЛЖНА быть в начале ответа. За командой ДОЛЖНА быть пустая строка.

Команды, допустимые только через почтовый интерфейс:

Передача сайта новому владельцу

Существует 2 возможности передачи сайта новому владельцу – передача по номеру телефона и парольная передача. Первый вариант – это передача другому.. Второй вариант предназначен, в основном, для передачи канала самому себе при смене номера телефона (сим-карты).

Создание простейших статических (без программирования) сайтов.

Ниже приведен текст письма, в котором содержатся рекомендации по созданию статического сайта – библиотеки 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:://ДОМЕН/EMSLIB/имяФайла.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 у Васи день рождения

на телефон придет логотип оператора с указанным текстом. И тогда Васю точно не забудете поздравить J

Описанный МАСТЕР-сайт не реализован и предлагается как идея. Функциональность такого сайта, на наш взгляд, будет востребована. Сама реализация достаточно проста.