Возвращает информацию о канве приложения в мобильном Моем Мире.
Функция предназначена для использования в мобильных социальных приложениях. Код двух блоков, который возвращает функция — заголовка и подвала — обязателен к размещению на всех страницах мобильного приложения в качестве самого первого и самого последнего визуального элемента.
Результат выполнения функции разрешается кешировать на время, не превышающее 1 минуты. Для каждого пользователя информация должна кешироваться отдельно.
Данный вызов не предназначен для запросов по защищенной схеме «сервер-сервер» (флаг secure не должен быть 1).
| Имя | Тип | Описание |
|---|---|---|
| mobile_spec | string | тип мобильного приложения (см. параметр mobile_spec), от этого параметра зависит какие именно заголовок и подвал будут возвращены; обязательный параметр |
Формат ответа для json-выдачи (результат для xml аналогичен):
{
"header": "...html...", // html заголовка, должен быть вставлен в начало страницы
"footer": "...html..." // html подвала, должен быть вставлен в конец страницы
}
| Код | Описание |
|---|---|
| 1 | Unknown error: Please resubmit the request. |
| 2 | Unknown method called. |
| 3 | Service Unavailable. Please try again later. |
| 4 | Method is deprecated. |
| 100 | One of the parameters specified is missing or invalid. |
| 102 | User authorization failed: the session key or uid is incorrect. |
| 103 | Application lookup failed: the application id is not correct. |
| 104 | Incorrect signature. |
| 105 | Application is not installed for this user. |
| 200 | Permission 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",
"footer":"\r\n\r\n\r\n"
}
Пример ответа в формате XML
<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>