mobile.getCanvas rest api

Возвращает информацию о канве приложения в мобильном Моем Мире.

Функция предназначена для использования в мобильных социальных приложениях. Код двух блоков, который возвращает функция — заголовка и подвала — обязателен к размещению на всех страницах мобильного приложения в качестве самого первого и самого последнего визуального элемента.

Результат выполнения функции разрешается кешировать на время, не превышающее 1 минуты. Для каждого пользователя информация должна кешироваться отдельно.

Данный вызов не предназначен для запросов по защищенной схеме «сервер-сервер» (флаг secure не должен быть 1).

Параметры

Имя Тип Описание
mobile_specstringтип мобильного приложения (см. параметр mobile_spec), от этого параметра зависит какие именно заголовок и подвал будут возвращены; обязательный параметр

Результат

Формат ответа для json-выдачи (результат для xml аналогичен):

{
    "header": "...html...", // html заголовка, должен быть вставлен в начало страницы
    "footer": "...html..." // html подвала, должен быть вставлен в конец страницы
}

Коды ошибок

КодОписание
1Unknown error: Please resubmit the request.
2Unknown method called.
3Service Unavailable. Please try again later.
4Method is deprecated.
100One of the parameters specified is missing or invalid.
102User authorization failed: the session key or uid is incorrect.
103Application lookup failed: the application id is not correct.
104Incorrect signature.
105Application is not installed for this user.
200Permission error: the application does not have permission to perform this action.

Пример вызова

http://appsmail.ru/platform/api?sig=16489adb1f1748432e425b1bcdbe174d&
session_key=cf55910387bb86a660fcd2b9999026b2&mobile_spec=smartphone&
app_id=475376&method=mobile.getCanvas

Пример ответа в формате JSON

{	
	"header":"\r\n\r\n
\r\n\t\r\n
", "footer":"\r\n\r\n
\r\n \r\n \r\n

© Mail.Ru, 1999–2013

\r\n
\r\n" }

Пример ответа в формате XML



	
<div class="b-footer"> <style type="text/css"> .b-footer { border-top: 1px solid #f8f8f8; } .b-footer, .b-footer a { font-family: Arial, sans-serif; } .b-footer .l-twoButtons { list-style: none; padding: 0; margin: 0; height: 30px; border-bottom: 1px solid #c8c8c9; border-top: 1px solid #c8c8c9; box-shadow: 0 1px 2px rgba(50, 50, 50, 0.1); position: relative; z-index: 1; } .b-footer .l-twoButtons .l-twoButtons_item { float: left; width: 50%;> display: block; height: 30px; background: url(\'http://img0.imgsmail.ru/r/mymobile/apps/canvas-button-bg.png\') repeat-x; border-bottom: 1px solid #d6d6d6; } .b-footer .l-twoButtons .l-twoButtons_item .l-twoButtons_link, .b-footer .l-twoButtons .l-twoButtons_item a { height: 30px; line-height: 29px; font-size: 14px; display: block; border-left: 1px solid #bbbbbb; border-top: 1px solid white; background: url(\'http://img0.imgsmail.ru/r/mymobile/apps/canvas-button-bg.png\') repeat-x; text-align: center; color: #242424; text-decoration: none; font-family: Arial, sans-serif; } .b-footer .l-twoButtons .l-twoButtons_item .l-twoButtons_link-apps { border-left: 0; } .b-footer p { text-align: center; margin-top: 10px; font-size: 12px; } .b-footer .l-twoButtons .l-twoButtons_item { width: 100%; } </style> <ul class="l-twoButtons"> <li class="l-twoButtons_item"> <a class="l-link l-twoButtons_link l-twoButtons_link-apps" href="http://m.my.mail.ru/apps">Все игры</a> </li> </ul> <p>&copy;&nbsp;Mail.Ru, 1999&ndash;2013</p></div>
<style> .b-head { height: 30px; background: url(\'http://img0.imgsmail.ru/r/mymobile/apps/canvas-header-bg.png\') repeat-x; } .b-head a { display: block; height: 30px; background: url(\'http://img1.imgsmail.ru/r/mymobile/apps/canvas-header.png\') no-repeat; }</style><div class="b-head"><a href="http://m.my.mail.ru/apps"></a></div>

Использование REST API

Функции REST API