Общая информация
Существует два различных типа мобильных виджетов: пользовательские (относящиеся к текущему пользователю) и прикладные (не связанные ни с одним пользователем).
Например, пользовательский виджет mobile-header содержит панель с логотипом и количество важных событий для текущего пользователя, а прикладной виджет mobile-header-small содержит только панель с логотипом без какой-либо информации, связанной с пользователями.
Пользовательские виджеты возвращаются методам виджетов запросами, подписанными ключом сессии.
Прикладные виджеты возвращаются методам виджетов запросами, подписанными ключом приложения.
Применение мобильных виджетов ДОЛЖНО полностью соответствовать следующим правилам:
- Пользовательские виджеты верхнего колонтитула ДОЛЖНЫ быть вставлены в любое мобильное приложение (игру) в верхней части любой страницы приложения.
- Наша политика позволяет кэшировать пользовательские виджеты на период максимум 5 минут.
- При каждом запуске мобильного приложения из портала odnoklassniki.ru вся кэшированная информация о пользовательских виджетах должна удаляться и запрашиваться заново.
- Если API-запрос на пользовательские виджеты не может быть обработан в отведенное время, не может быть обработан успешно или просто возвращает ошибку, приложение ДОЛЖНО использовать прикладные виджеты вместо пользовательских. Это единственный случай, когда приложение может заменить пользовательские виджеты на прикладные аналоги.
- Наша политика позволяет кэшировать прикладные виджеты на период максимум 24 часа.
Мобильные виджеты
На данной странице приведены виджеты, доступные через Odnoklassniki API. Используйте методы widget.getWidgetContent и widget.getWidgets, чтобы получить содержимое виджета и встроить в свое приложение. Приложение может выбрать один из предложенных вариантов виджета:
| Идентификатор | Описание | Пример |
|---|---|---|
| переданный в GET параметрах (header_widget) | В зависимости от ряда условий сайт Одноклассники может передать название требуемого виджета в игру. Если он указан, запрашивать надо именно его. Визуально переданный виджет аналогичен mobile-header-small и поддерживает все те же стили | |
| mobile-header-small | Этот виджет представляет собой маленькую кнопку возврата в Одноклассники и ДОЛЖЕН быть размещен в верхней части всех страниц мобильного HTML-приложения. Виджет поддерживает стили указанные в примере. |  |
| mobile-header | Устаревший. Не поддерживает стили. Этот виджет содержит верхний колонтитул, который ДОЛЖЕН быть размещен в верхней части всех страниц мобильного HTML-приложения. Он содержит заголовок Odnoklassniki и интерактивную панель инструментов со списком всех новых событий пользователя. * Запрос mobile-header, подписанный ключом сессии, возвращает пользовательский верхний колонтитул, а подписанный ключом приложения запрос возвращает прикладной верхний колонтитул. Более подробно ситуация описана в разделе Общая информация выше |  |