Skip to main content
POST
Возвращает опубликованные новости, доступные указанному модератору в выбранном серверном контексте. Требуется news:read. При management=true возвращает список для управления со статусами и счётчиками. Вместо news:read требуются news:write и права управления новостями в CRM. Видимость проверяется дополнительно к правам бота. Закрытые глобальные аудитории требуют отдельного news:global. Для продолжения передайте next_cursor как cursor.

Доступ

news:read для ленты. При management=true требуются news:write и право модератора управлять новостями в CRM.
string
required
Партнёрский Bearer-токен. Подробнее в разделе «Авторизация».

Параметры

Тело запроса

Передайте JSON с заголовком Content-Type: application/json.
string[] | null
Фильтр по идентификаторам авторов. Допустимые авторы возвращаются в facets. До 100 элементов.
string
Курсор из next_cursor предыдущей страницы. В первом запросе не передавайте. До 4096 символов.
integer
Максимальное число записей в одной странице. По умолчанию 25. Диапазон от 1 до 100.
boolean
Запросить управленческий список новостей с проверкой соответствующих полномочий модератора.
object
required
Модератор, который инициировал действие через бота. CRM определяет его аккаунт по привязанному внешнему ID и проверяет полномочия.
string
Порядок сортировки списка. Допустимые значения asc, desc.
string
Начало интервала публикации для фильтра новостей. До 10 символов.
string
Конец интервала публикации для фильтра новостей. До 10 символов.
string
Фильтры и параметры страницы. До 120 символов.
string | integer
required
Уникальный номер сервера из GET /api/partner/v1/servers или UUID сервера. Сервер должен входить в выданный боту доступ.
string
Направление сортировки: asc — по возрастанию, desc — по убыванию. Допустимые значения default, title, author, published, updated.
string
Текущее состояние записи. Допустимые значения draft, published, scheduled, archived, deleted.

Успешный ответ

HTTP 200. Запрос выполнен успешно.
boolean
required
Может ли модератор управлять новостью.
object
Количество записей по состояниям.
object[] | null
required
Записи текущей страницы.
string
Курсор следующей страницы. Пустое значение или отсутствие поля означает, что следующей страницы нет.
integer
Общее количество записей или показатель источника.

Ошибки

См. формат ошибок и правила повторов.

Пример

В примере использованы условные идентификаторы.