stream.share rest api

Поделиться ссылкой

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

Параметры

Имя Тип Описание
urlstringURL страницы; обязательный параметр
descriptionstringописание страницы
titlestringтекст заголовка, он будет выделен жирным шрифтом
img_urlstringurl картинки, которая будет сопровождать запись
user_textstringтекст комментария пользователя

Ограничение на длину всех параметров — 400 символов.

Если url картинки, описание или заголовок не заданы, то робот попытается найти их самостоятельно, запросив страницу.

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

Результат

Возвращает history_id вставленной записи в случае успеха, publish_error в противном случае

Коды ошибок

КодОписание
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://www.appsmail.ru/platform/api?method=stream.share&
app_id=123456&session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=95a393ed7639184a52f7a17b6771a92&url%3Dhttp%3A%2F%2Fmail.ru%0A

См. также

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

Функции REST API