- Mail.Ru API
- Как разработать социальное приложение
- Архитектура приложения
- Инициализация приложения
- Параметры инициализации приложения
- Параметры
- Как разрабатывать приложение
- Что делать дальше
- Мойдом — сервисы умного города 9+
- Участвуй в жизни своего города
- MoyDom, LLC
- Для iPhone
- Снимки экрана (iPhone)
- Описание
Mail.Ru API
Социальная сеть Мой Мир@Mail.Ru позволяет размещать внутри себя социальные приложения. Такие приложения имеют доступ к данным пользователей сети и каналам распространения в ней. За счет этого социальные приложения добились высокой популярности среди пользователей.
Как разработать социальное приложение
Чтобы создать и запустить социальное приложение надо пройти несколько шагов:
- зарегистрировать приложение
- разработать клиентскую и серверную часть приложения
- пройти модерацию и попасть в каталог
Разместить свое приложение может любой пользователь Моего Мира, но для монетизации есть некоторые ограничения. Подробности см. в руководстве по подключению биллинга.
Помните, все приложения, размещенные на Платформе, должны удовлетворять правилам размещения приложений. Вы можете разрабатывать приложение без общения с модераторами, в этом режиме оно доступно только вам и указанным вами тестерам. При подаче запроса на публикацию приложение в обязательном порядке модерируется.
Архитектура приложения
Социальное приложение размещается в iframe внутри страницы Моего Мира — канвы (пример). Это означает, что технически процесс создания приложения мало чем отличается от создания веб-сайта.
Обычно приложение имеет две части: клиентскую и серверную. Клиентская часть отображается пользователю и может быт сделана на всем, что умеет отображать браузер, например, Flash, Silverlight, Unity 3D или просто HTML+JavaScript.
Серверная часть может быть разработана на любой технологии, которая может возвращать HTML для клиентской части. Обычно серверная часть нужна для хранения данных, например, рейтингов игроков и для приема платежей при работе с биллингом.
Платформа поддерживает два типа приложений: iframe и flash. Iframe — общий тип, который позволяет вам использовать любые технологии. Тип flash облегчает работу если клиентская часть вашего приложения написана на Flash, либо у вашего приложения нет своего хостинга.
Мы рекомендуем вам всегда выбирать тип iframe, в том числе и если у вас Flash-приложение, потому что он предоставляет больше возможностей, например, публикацию новостей под приложением. Кроме того, тип flash объявлен устаревшим и в дальнейшем будет выключен — все приложения, Flash- и другие, будут вставляться через тип iframe.
Инициализация приложения
Когда пользователь открывает ваше приложение в Моем Мире, ему отображается страница с iframe’ом, указывающим на ваши сервера (адрес вы задаете в настройках приложения). Чтобы вы могли использовать API Платформы, в GET-парметрах iframe’а передаются также дополнительные данные (для приложений типа flash аналогичные данные передаются автоматически через FlashVars).
Параметры инициализации приложения
Все указанные параметры передаются при каждом открытии страницы приложения.
Параметры
| Имя | Тип | Описание |
|---|---|---|
| app_id | int | идентификатор вашего приложения |
| session_key | string | идентификатор сессии |
| session_expire | timestamp | время в формате unixtime когда сессия перестанет быть валидной |
| oid | uint64 | идентификатор пользователя, установившего приложение |
| vid | uint64 | идентификатор пользователя, запустившего приложение |
| is_app_user | bool | флаг, обозначающий установил ли приложение пользователь просматривающий приложение (1 — установил, иначе 0) |
| ext_perm | string | пользовательские настройки приложения; значением данного параметра является перечисление через запятую настроек пользователя, описанных в документации к методу users.hasAppPermission rest ; например: ext_perm=stream,notifications |
| window_id | string | идентификатор окна, в котором запущено приложение |
| view | string | определяет место, из которого открыто приложение |
| referer_type | string | определяет тип реферера (см. Бонус за друга); необязательный параметр |
| referer_id | string | определяет id реферера (см. Бонус за друга); необязательный параметр |
| sig | string | подпись параметров |
Идентификатор сессии session_key используется для вызовов REST API. Подробности читайте в руководстве по использованию REST API. Параметр vid всегда содержит идентификатор текущего пользователя приложения. Параметр oid зависит от способа запуска приложения: пользователь мог запустить приложение со своей личной страницы, тогда oid будет идентичен vid. Если пользователь зашел на приложение со страницы другого человека, установившего его, то oid будет содержать идентификатор установившего приложение пользователя. Параметр window_id используется только для вызова функции payments.openDialog rest . Параметр view для приложений в Моем Мире всегда равен app_canvas. Параметр sig является подписью параметров инициализации приложения. Мы настоятельно рекомендуем вам проверять подпись параметров дабы избежать их подделки злоумышленниками. Расчет подписи происходит по схеме сервер-сервер REST API.
Обратите внимание, что параметр sig в расчете подписи не участвует. Так как подпись содержит секретный ключ secret_key, то ее можно проверить только на сервере. Параметры state и authentication_key объявлены устаревшими и оставлены для обратной совместимости.
Как разрабатывать приложение
Используя параметры, переданные при инициализации приложения, вы можете обращаться ко всем API, предоставляемым Платформой. Для разработки клиентской части приложения рекомендуем вам использовать JS API и Flash-библиотеку если у вас Flash-приложения, так как это существенно облегчает разработку. Для взаимодействия ваших серверов с серверами Платформы используйте REST API, которое можно использовать из любых языков программирования.
Что делать дальше
Вы можете зарабатывать деньги на вашем социальном приложении. Для этого ознакомьтесь с руководством по монетизации.
Для продвижения вашего нового приложения используйте возможности рекламы в Моем Мире.
Источник
Мойдом — сервисы умного города 9+
Участвуй в жизни своего города
MoyDom, LLC
Для iPhone
Снимки экрана (iPhone)
Описание
«Мой дом» — это универсальная платформа активного гражданина в соответствии с проектом «Умный город».
Приложение работает в 5 городах: Кострома, Рыбинск, Владимир, Псков, Аксай.
Установка приложения в городе или области осуществляется при содействии местных органов власти и поддержке администрации.
В зависимости от настроек города пользователям доступны следующие модули:
Сообщение о проблемах.
Отправляйте сообщения в соответствии с доступными типами проблем (доступный перечень обращений определяется в администрации города). Ваше обращение автоматически попадает в нужную организацию. Вы можете контролировать ход выполнения работ по вашему сообщению, следить за сменой статуса. При возникновении уточняющих вопросов предусмотрен чат между пользователем (жителем) и диспетчером организации, ответственной за устранение данной проблемы. По завершении работ можно оценить качество оказанной услуги или отклонить решение, если вы не удовлетворены с решением которое сделал исполнитель.
Отключения и ремонтные работы.
Узнавайте об отключениях электричества, отопления, холодной и горячей воды. В приложении всегда доступна актуальная информация по ремонтным работам для всего города. Подпишитесь на интересующие вас адреса и получайте звуковые уведомления с информацией по отключениям в вашем доме.
Голосования и социальные опросы.
На проекте «Мой дом» проводятся голосования по наиболее актуально острым вопросам, затрагивая такие темы, как транспорт, образование, ЖКХ, вопросы городского развития. Формированием и проведением голосования занимается администрация города или региона, поэтому вопросы, вынесенные на рассмотрение, имеют большое значения для улучшения и развития вашего города.
Городские оповещения.
Получайте оповещения о важных событиях города — сообщения о ремонте дорог и объездных маршрутах, афишу с расписанием городских праздников, штормовые предупреждения от МЧС и многое другое.
Новости города.
В разделе новостей размещаются свежие статьи о том, чем живет город. Вы можете узнать о развитии региона, последних культурных событиях, борьбе с преступностью, исторических местах и героях города; интервью с горожанами и другие материалы.
Как это работает?
Функционирование проекта на территории города или области осуществляется при поддержке администрации. При невыполнении работ по вашему сообщению подрядной организацией (УК, ресурсоснабжающие организации, мусорный оператор и т.д.) администрация города будет самостоятельно контролировать ход работ по вашему сообщению.
Информация об отключениях поступает напрямую от официальных источников: ресурсоснабжающих организаций, информационных отделов администрации города, диспетчерских служб управляющих компаний. В каждой организации установлена специализированная админпанель.
Информация городских оповещениях, планов городских властей и новостях поступает от отделов администрации города и пресслужбы города.
Источник