Как построить планировщик постов в соцсетях на API: очередь, медиа и статусы
Чтобы построить планировщик соцсетей на Partner API easyCoexistence, ваш сервер отправляет каждый пост в POST /channels/:id/posts с текстом, медиа и publish_at от 1 минуты до 90 дней вперёд. easyCoexistence сразу копирует медиа и публикует пост в назначенное время в Instagram, Facebook, TikTok или LinkedIn, сообщая о каждом шаге как о статусе и через события post.published и post.failed.
Как далеко вперёд API постов планирует публикации в Instagram, Facebook, TikTok и LinkedIn; минимальное время: через 1 минуту.
Максимальный размер изображения и видео, которые easyCoexistence копирует при планировании поста; файл большего размера отклоняется в этот момент.
Повторные попытки поста, которому сеть ограничила частоту запросов, до того как он получит статус failed.
Количество постов через API, которые аккаунт Instagram может опубликовать за любые 24 часа; карусель считается одним постом.
Лимит TikTok на видеопосты одного аккаунта через его эндпоинт публикации: не более шести в минуту.
Что нужно планировщику от API?
Пять вещей: место для загрузки файлов, вызов, который ставит пост в очередь одного аккаунта, очередь, которая публикует вовремя, способ изменить решение и сведения о том, что произошло. API постов даёт каждое из них по тому же ключу ec_live_, что подключает ваших клиентов, поэтому календарь, процесс согласования и редактор остаются в вашем продукте.
Как запланировать пост?
Один POST на каждый аккаунт по адресу https://easycoexistence.com/api/v1/channels/:id/posts, где :id равен channel_id из сессии подключения клиента. publish_at задаётся в формате ISO 8601 с Z или смещением; не указывайте его, чтобы опубликовать сейчас. Ответ: 201 с постом либо 422, если пост на сейчас не удался. Заголовок Idempotency-Key учитывается, поэтому повторный запрос после таймаута не ставит пост в очередь дважды. Тело запроса содержит:
- text: подпись, сообщение или комментарий; media: список {url, type} или {
media_id}. - link: ссылка-пост на Facebook или статья в LinkedIn, с заголовком для LinkedIn.
ig_type: IMAGE, CAROUSEL, REELS или STORIES, определяется по медиа, если не указан.- title и
disable_commentдля фотопостов TikTok;image_altдля изображения в LinkedIn.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Idempotency-Key: campaign-311-ig" \
-H "Content-Type: application/json" \
-d '{
"text": "Three looks for the weekend",
"media": [
{ "url": "https://cdn.example.com/looks/1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/looks/2.jpg", "type": "image" }
],
"ig_type": "CAROUSEL",
"publish_at": "2026-11-20T09:00:00-05:00"
}'Как планировщик работает с медиа?
Либо по ссылке, либо загрузкой. Публичная ссылка HTTPS сразу попадает в поле media; файл, который загружают ваши пользователи, отправляется на POST /media как тело запроса с Content-Type и Content-Length или как {"url"}, а media_id из ответа вставляется в пост. Когда пост планируется, easyCoexistence копирует его файлы, поэтому ссылка должна работать только в этот момент. Веб-страница вместо файла, ошибка 404, неверный тип или файл больше 30 МБ для изображений либо 1 ГБ для видео отклоняются уже тогда, а не в утро публикации.
Что может нести пост каждой сети?
Очередь проверяет каждый пост по правилам сети до его принятия. Пост, который их нарушает, отклоняется с сообщением, в котором названо правило, чтобы ваш редактор мог показать проблему, пока пользователь ещё редактирует. Каждая сеть принимает:
Через какие статусы проходит пост?
Шесть, которые сообщают GET /posts/:id и GET /posts вместе с publish_at, ссылкой на опубликованный пост и ошибкой сети, если он не прошёл:
- scheduled: в очереди, ждёт своего времени.
- publishing: передан сети.
- processing: сеть ещё работает над ним, как с видео TikTok или контейнером Instagram.
- published: опубликован, со ссылкой.
- failed: отклонён или не подтверждён;
may_be_publishedотмечает пост, который сеть могла получить. - canceled: удалён до выхода, вами или потому что его канал был удалён или приостановлен.
Как редактировать, отменить или повторить пост?
PATCH /posts/:id меняет время или текст запланированного поста, а также заголовок фотопоста TikTok; чтобы изменить медиа, отмените пост и запланируйте новый. DELETE /posts/:id отменяет его. POST /posts/:id/retry публикует неудавшийся пост снова, прямо сейчас. Пост, которому сеть ограничила частоту запросов, повторяется сам через 5 минут, 30 минут и 2 часа, а пост с отметкой may_be_published перед любым повтором требует проверки аккаунта.
Как планировщик узнаёт о результатах?
Из событий и из списка. URL для событий статуса, заданный в разделе Profile, Developers, получает post.published и post.failed, подписанные X-EC-Signature, как и все остальные события, с постом и его каналом, чтобы ваш календарь отмечал каждый как опубликованный или помечал его. GET /posts принимает status, from, to и limit для представлений календаря, а GET /channels/:id/posts выводит один аккаунт. Пост, который не удался в фоне, также отправляет письмо владельцу аккаунта, не чаще одного раза на канал каждые 3 часа.
Как посты LinkedIn вписываются в планировщик?
С участием человека, который утверждает каждый. Условия API LinkedIn ограничивают использование его API для автоматизации публикаций, поэтому планировщик хранит каждый пост LinkedIn как черновик в вашем продукте, пока названный человек его не утвердит, и только затем отправляет с publish_at. Повторяющиеся правила, ленты и массовый импорт должны идти в другие сети, а LinkedIn оставьте для постов, которые кто-то проверил.
Распространённые ошибки
- Отправка publish_at без смещения. Локальное время без Z или смещения отклоняется, поэтому отправляйте 2026-11-20T09:00:00-05:00, а не голое время, которое выбрал пользователь.
- Повторная попытка поста с отметкой may_be_published сразу. Сеть может уже показывать его, поэтому сначала проверьте аккаунт, иначе пост выйдет дважды.
- Повтор запроса POST после таймаута без Idempotency-Key. Дайте каждому посту свой ключ, чтобы повторный запрос возвращал уже поставленный в очередь пост, а не планировал вторую копию.
- Загрузка PNG для Instagram. API публикаций Instagram принимает только JPEG, и пост отклоняется при планировании, поэтому конвертируйте изображения на шаге загрузки.
easyCoexistence даёт вашему планировщику одну очередь для аккаунтов клиентов в Instagram, Facebook, TikTok и LinkedIn и другие каналы через официальные API каждой сети: копирование медиа при планировании, шесть статусов, повторы при ограничении частоты и подписанные события постов, с круглосуточным мониторингом каждого подключения. От US$ 9 до US$ 0,75 за подключение в месяц, с падением по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли один запрос запланировать пост в нескольких сетях?
Каждый запрос относится к одному каналу, поэтому отправляйте по одному на аккаунт, у каждого со своим Idempotency-Key, и адаптируйте текст под ограничения каждой сети.
Планирует ли API постов видео YouTube?
YouTube планирует публикации сам. Загрузите видео через API YouTube как приватное с publishAt, используя токен из GET /channels/:id?credentials=1, и YouTube сделает его публичным в это время.
Могут ли пользователи видеть запланированные посты в панели управления easyCoexistence?
Экран Posts принадлежит вашему аккаунту, поэтому ваша команда видит там разделы «Требует внимания», «Скоро» и «Опубликовано», с кнопками «Отменить», «Повторить» и «Скрыть». Ваши пользователи видят календарь, который ваш продукт строит на основе GET /posts.
Сколько стоит easyCoexistence для планировщика соцсетей?
От US$ 9 до US$ 0,75 за подключённый аккаунт в месяц, с падением по мере того, как ваши пользователи подключают больше, с включённым планированием и первыми 3 днями бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на