widget.set rest api

Публикует виджет приложения на профиле пользователя в «Моем мире».

Отключен 28 июля 2011.

Для вызова функции требуется привилегия widget.

На количество публикаций виджета в день ограничения не накладываются, поэтому виджет приложения удобно использовать для отражения статуса игрока по какому-то событию, даже без присутствия пользователя он-лайн.

Удаление пользователем виджета с страницы профиля автоматически снимает разрешение вашему приложению на использование функции widget.set для этого пользователя.

Функция может быть вызвана только с сервера приложения и работает только по защищенной схеме «Сервер - Сервер».

Параметры

Имя Тип Описание
htmlstringHTML код виджета, который будет размещен на странице пользователя; обязательный параметр

Ограничения на параметр html

Внутри виджета допустимы следующие теги HTML: b, strong, i, em, u, a, br, p, img, div, span, ul, ol, li. Для всех тэгов разрешен атрибут style, для img разрешен alt. Не поддерживаемые тэги будут вырезаны из кода виджета. Максимальные размеры виджета — 200×180 пикселей, максимальный объем кода — 3000 символов.

Результат

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

  1. { "set": 1 }

Коды ошибок

КодОписание
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.
201The application can't publish more news in stream in 24 hours.
401Widget data is too long.

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

http://www.appsmail.ru/platform/api?method=widget.set&app_id=422248&
sig=f0def7f721a3c45f70617b78d8d9fba0&html=hello&
uid=11798822023276760714&secure=1

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

  1. { "set": 1 }

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

  1.  
  2. 1

См. также

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

Функции REST API