stream.post rest api

Добавляет запись в поток «Что нового» пользователя.

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

Параметры

Имя Тип Описание
user_textstringтекст сообщения пользователя в формате plaintext, максимум 140 символов, обязательный параметр, если не задан text.
textstringосновной текст сообщения, обязательный параметр, если не задан user_text.
titlestringтекст заголовка, он будет выделен жирным шрифтом
link1_textstringтекст (название) первой ссылки, имеет смысл только при заданном url первой ссылки
link1_hrefstringurl первой ссылки, имеет смысл только с заданным текстом первой ссылки
link2_textstringтекст (название) второй ссылки, имеет смысл только при заданном url второй ссылки
link2_hrefstringurl второй ссылки, имеет смысл только с заданным текстом второй ссылки
img_urlstringurl картинки, которая будет отображаться слева от записи

Ограничение на длину заголовка и текста — 400 символов. Ограничение на длину текста ссылок — 20 символов.

Если у значение link1_text или link2_text будет равно "default", то этот линк будет на тексте и картинке сообщения (если она задана) и не будет отображаться в списке линков под записью

Обратите внимание, что абсолютные URL'ы в link_href'ах работают только для внешних сайтов, для приложений ссылка под записью всегда будет вести на страницу приложения, а href будет дописан в якорь (после #).

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

Результат

Возвращает объект вставленной записи в формате, аналогичном stream.getrest.

Коды ошибок

КодОписание
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.post&app_id=123456&
session_key=551fd0e4779e35859dfccd03397dc8a0&
sig=95a393ed7639184a52f7a17b6771a92&text=test

См. также

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

Функции REST API