Skip to main content
POST
Выполняет operation=create, update, state или delete. Требуется news:write, управленческие права модератора в CRM, Idempotency-Key и актуальная expected_version для существующей новости. Создание формирует черновик. Для публикации используйте state=published, для отложенной публикации — state=scheduled и publish_at. Аудитория серверной новости ограничена согласованными серверами. Публичная аудитория, аудитория по ролям или пользователям требуют отдельно выданного news:global. Этот метод не загружает изображения и обложки: допустимы только уже существующие ресурсы новостей CRM.

Доступ

news:write и право модератора управлять новостями в CRM. Для общей аудитории, ролей или конкретных пользователей дополнительно требуется news:global.
string
required
Партнёрский Bearer-токен. Подробнее в разделе «Авторизация».

Особенности

В примере создаётся черновик для указанного сервера. Для существующей новости возьмите её version из актуального ответа и используйте как expected_version.

Параметры

string
required
Уникальный ключ действия: от 16 до 128 печатных ASCII-символов без пробелов. При повторе того же запроса используйте тот же ключ. Для нового действия создайте новый. До 128 символов.

Тело запроса

Передайте JSON с заголовком Content-Type: application/json.
object
required
Параметры действия.
object
required
Модератор, который инициировал действие через бота. CRM определяет его аккаунт по привязанному внешнему ID и проверяет полномочия.
string | integer
required
Уникальный номер сервера из GET /api/partner/v1/servers или UUID сервера. Сервер должен входить в выданный боту доступ.

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

HTTP 200. Запрос выполнен успешно.
object
Данные новости.
boolean
required
Была ли запись удалена.

Ошибки

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

Пример

Подставьте свои ID, а для изменения используйте отдельный ключ операции и ревизию из CRM.