Интеграции и автопостинг

Раздел «Разработчики» в приложении — точка входа для интеграций. Здесь ты создаёшь API-ключи для работы с публичным REST API v1, настраиваешь вебхуки, чтобы получать события о постах на свой сервер, и подключаешь автопостинг из RSS — когда новые статьи из твоей ленты автоматически превращаются в посты.

API-ключи

API-ключ нужен для любых запросов к публичному API. Чтобы создать ключ:

Открой раздел «Разработчики» и нажми «Создать ключ».
Выбери права (scopes) — что именно ключ сможет делать.
Скопируй ключ сразу после создания.

Права (scopes)

Scope	Что разрешает
`posts:read`	Читать посты
`posts:write`	Создавать и публиковать посты
`accounts:read`	Смотреть список подключённых соцсетей
`media:read`	Читать медиафайлы
`media:write`	Загружать медиафайлы

Выдавай ключу только те права, которые реально нужны интеграции — так безопаснее.

Авторизация и лимит

Ключ передаётся в заголовке Authorization: Bearer sk_... либо x-api-key: sk_....

Лимит публичного API — 60 запросов в минуту на ключ. При превышении запросы начнут отклоняться, подожди минуту и продолжай.

Отзыв ключа

Если ключ скомпрометирован или больше не нужен — удали его в списке ключей. Он перестанет работать сразу, запросы с ним будут отклоняться.

Пример — создать пост через curl

curl -X POST https://api.repost21.com/v1/posts \
  -H "Authorization: Bearer sk_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Привет из API 👋",
    "platforms": ["TELEGRAM"],
    "scheduledAt": "2026-07-01T09:00:00Z"
  }'

Без scheduledAt создаётся черновик, с будущей датой — пост попадает в «Контент-план» и публикуется по расписанию. Полный список эндпоинтов — в справочнике REST API v1.

Вебхуки

Вебхуки присылают HTTP-запрос на твой сервер, когда в Repost21 происходит событие. Чтобы настроить:

В разделе «Разработчики» добавь вебхук — укажи URL своего эндпоинта.
Выбери события, на которые хочешь подписаться.
Сохрани секрет — как и API-ключ, он показывается только один раз.

События

Событие	Когда приходит
`post.created`	Пост создан
`post.published`	Пост успешно опубликован
`post.failed`	Публикация завершилась ошибкой

Подпись и проверка

Каждая доставка приходит POST-запросом с заголовками:

Заголовок	Что содержит
`x-repost21-event`	Название события
`x-repost21-signature`	Подпись вида `sha256=<hex>`
`x-repost21-delivery`	ID доставки

Подпись — это HMAC-SHA256 от тела запроса, посчитанный с твоим секретом. Обязательно проверяй её на своей стороне: посчитай HMAC-SHA256 от полученного тела с секретом и сравни с заголовком. Так ты убедишься, что запрос пришёл именно от Repost21. Готовый пример проверки на Node.js есть в блоке «Быстрый старт» раздела «Разработчики».

Любой вебхук можно временно выключить тумблером, не удаляя — удобно на время отладки.

Автопостинг из RSS

Автопостинг превращает новые статьи из RSS-ленты в готовые посты — без твоего участия. Подходит для блога, новостного сайта или любого источника с RSS.

В разделе «Разработчики» найди блок «Автопостинг из RSS» и добавь ленту — укажи её URL. Поддерживаются форматы RSS 2.0 и Atom.
Выбери соцсети, в которые публиковать, тон и язык постов.
Задай частоту проверки ленты — по умолчанию она проверяется каждые 6 часов.

Когда в ленте появляются новые статьи, AI читает их и готовит посты под выбранные соцсети. По умолчанию посты создаются как черновики — ты просматриваешь их в «Контент-плане» и публикуешь сам. Если включить автопубликацию, посты будут уходить в соцсети сразу, без проверки.

Что дальше

Полный справочник эндпоинтов — REST API v1
Работа с постами и расписанием в интерфейсе — Посты и контент-план
CRM-интеграции (AmoCRM, Bitrix24, RetailCRM, Zapier, Make, Slack) — в разработке, в разделе «Разработчики» они помечены «Скоро»