Sponsr API: публикация постов, отправка личных сообщений подписчикам

Теперь авторы Sponsr могут публиковать посты и отправлять сообщения подписчикам через API. Это экономит время, когда контент публикуется на разных платформах. А также позволяет создавать новые сценарии для подписчиков.

Публикация поста

Для публикации поста используйте метод:

POST sponsr.ru/api/v2/external-api/post

Headers:

accept: application/json 
X-API-KEY

Тело запроса:

{
 "level_id": 0,
 "date": "2026-06-17",
 "title": "string",
 "text": "string",
 "is_extended_view": true,
 "is_pinned": false,
 "is_markdown": false,
 "is_notified": true,
 "access_type": "all",
 "access_value": 4294967295,
 "tag_id": [1,2],
 "meta_title": "string",
 "meta_description": "string"
}

Параметры запроса:

level_id — ID уровня подписки;
date — дата публикации в формате ISO 8601;
title — заголовок поста. От 4 до 256 символов;
text — содержимое поста;
is_extended_view — показывать пост в развернутом виде (true / false);
is_pinned — закрепить пост (true / false);
is_markdown — применить markdown к тексту (true / false);
is_notified — не оповещать о публикации поста (true / false)
access_type — тип доступа к посту (all , active , continuity);
access_value — дополнительный параметр для access_type при значении active , continuity ;
tag_id — ID существующей подборки, в которую нужно добавить пост (можно передавать несколько tag_id);
meta_title — SEO-заголовок страницы;
meta_description — SEO-описание страницы.

Пример ответа в случае успеха:

{
  "data": {
    "id": 51753,
    "url": "sponsr.ru/spnsrtst/51753/Proverka",
    "editor": "sponsr.ru/spnsrtst/manage/post/51753"
  }
}

Описание ответа:

id — ID созданного поста;
url — публичная ссылка на пост;
editor — ссылка на редактирование поста через UI.

Отправка личного сообщения подписчику

Теперь можно отправлять личные сообщения через API и автоматизировать коммуникацию с подписчиками. Например, для автоматических приветственных сообщений или отправки секретных кодов.

POST sponsr.ru/api/v2/external-api/projects/subscribers/message

Headers:

 accept: application/json
 Content-Type: application/json
 X-API-KEY

Тело запроса:

{
 "user_id": 0,
 "content": "string"
}

Параметры запроса:

user_id — ID получателя. Получатель должен быть активным подписчиком вашего проекта;
content — Текст сообщения до 5000 символов.

В случае успеха сервер отдаст статус-код 201 CREATED, а в мессенджере появится сообщение, которое было отослано в теле запроса. В противном случае сервер выдаст ошибку

Примеры ответов в случае неудачи:

{ "message": "User is not an active subscriber of the project", 
 "statusCode": 403 }

{ "message": "content should not be empty",
  "error": "Bad Request",
  "statusCode": 400 }

Чтобы узнать подробнее про внешнее API — см. нашу статью Документация Sponsr API

Если у вас есть вопросы или предложения — пишите: