guestbook.post rest api

Добавляет запись в гостевую книгу пользователя.

Для вызова функции требуется привилегия guestbook. Вы можете добавить запись в гостевую книгу без запроса привилегий с помощью функции guestbook.postjs.

Возможно размещение картинки, которая будет сопровождать запись в гостевую книгу. Картинку можно загрузить двумя способами: передать URL картинки в интернете или загрузить через POST запрос. Если картинка добавляется через URL, то для сокращения нагрузки на ваши сервера, она будет показываться через кеширующий прокси-сервер, который будет периодически обращаться к вашим серверам для обновления данных о картинке.

Метод guestbook.post открыт только для приложений и запрещен для сайтов. Сайтам следует использовать аналогичный метод JS API.

Параметры

Имя Тип Описание
uidunsigned int64идентификатор пользователя, в чью гостевую книгу будет сделана запись; обязательный параметр
titlestringзаголовок записи
descriptionstringсодержимое публикуемой записи; обязательный параметр
user_textstringтекст сообщения от имени пользователя, сопровождающий запись
img_urlstringссылка на картинку
img_filefileдля POST-запроса: файл картинки; не учитывается если указан img_url; обратите внимание, параметр не участвует в формировании подписи запроса
link1_hrefstringпараметр первой ссылки
link1_textstringтекст первой ссылки; до 20 символов
link2_hrefstringпараметр второй ссылки
link2_textstringтекст второй ссылки; до 20 символов

Ссылки имеют смысл для социальных приложений в Моем Мире и для внешних сайтов. В первом случае параметры сылки дописываются к адресу приложения в Моем Мире после '#', например, http://my.mail.ru/cgi-bin/my/app-canvas?appid=<app_id>#my_param_1. Для сайтов ссылки вставляются как есть, но проверяются на совпадение с доменом сайта.

Если размер картинки, указанной в img_url или img_file, превышает 420×280 пикселей, то она будет пропорционально уменьшена.

Результат

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

  1. { "post" : 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.
501Image is incorrect or inaccessible.

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

http://www.appsmail.ru/platform/api?method=guestbook.post&
app_id=123456&session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=95a393ed7639184a52f7a17b6771a925&text=hello_world&
uid=12345678901234567890

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

  1. { "post" : 1 }

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

  1. <response_guestbook_post>
  2.      <post>1</post>
  3. </response_guestbook_post>

См. также

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

Функции REST API