Добавляет запись в гостевую книгу пользователя.
Для вызова функции требуется привилегия guestbook. Вы можете добавить запись в гостевую книгу без запроса привилегий с помощью функции guestbook.postjs.
Возможно размещение картинки, которая будет сопровождать запись в гостевую книгу. Картинку можно загрузить двумя способами: передать URL картинки в интернете или загрузить через POST запрос. Если картинка добавляется через URL, то для сокращения нагрузки на ваши сервера, она будет показываться через кеширующий прокси-сервер, который будет периодически обращаться к вашим серверам для обновления данных о картинке.
Метод guestbook.post открыт только для приложений и запрещен для сайтов. Сайтам следует использовать аналогичный метод JS API.
| Имя | Тип | Описание |
|---|---|---|
| uid | unsigned int64 | идентификатор пользователя, в чью гостевую книгу будет сделана запись; обязательный параметр |
| title | string | заголовок записи |
| description | string | содержимое публикуемой записи; обязательный параметр |
| user_text | string | текст сообщения от имени пользователя, сопровождающий запись |
| img_url | string | ссылка на картинку |
| img_file | file | для POST-запроса: файл картинки; не учитывается если указан img_url; обратите внимание, параметр не участвует в формировании подписи запроса |
| link1_href | string | параметр первой ссылки |
| link1_text | string | текст первой ссылки; до 20 символов |
| link2_href | string | параметр второй ссылки |
| link2_text | string | текст второй ссылки; до 20 символов |
Ссылки имеют смысл для социальных приложений в Моем Мире и для внешних сайтов. В первом случае параметры сылки дописываются к адресу приложения в Моем Мире после '#', например, http://my.mail.ru/cgi-bin/my/app-canvas?appid=<app_id>#my_param_1. Для сайтов ссылки вставляются как есть, но проверяются на совпадение с доменом сайта.
Если размер картинки, указанной в img_url или img_file, превышает 420×280 пикселей, то она будет пропорционально уменьшена.
Формат ответа для json-выдачи (результат для xml аналогичен):
{ "post" : 1 }
| Код | Описание |
|---|---|
| 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. |
| 501 | Image 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
{ "post" : 1 }
Пример ответа в формате XML
1