ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

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

Чтобы построить планировщик соцсетей на Partner API easyCoexistence, ваш сервер отправляет каждый пост в POST /channels/:id/posts с текстом, медиа и publish_at от 1 минуты до 90 дней вперёд. easyCoexistence сразу копирует медиа и публикует пост в назначенное время в Instagram, Facebook, TikTok или LinkedIn, сообщая о каждом шаге как о статусе и через события post.published и post.failed.

90 days

Как далеко вперёд API постов планирует публикации в Instagram, Facebook, TikTok и LinkedIn; минимальное время: через 1 минуту.

30 MB and 1 GB

Максимальный размер изображения и видео, которые easyCoexistence копирует при планировании поста; файл большего размера отклоняется в этот момент.

5 min, 30 min, 2 h

Повторные попытки поста, которому сеть ограничила частоту запросов, до того как он получит статус failed.

100 posts

Количество постов через API, которые аккаунт Instagram может опубликовать за любые 24 часа; карусель считается одним постом.

15 a day

Лимит TikTok на видеопосты одного аккаунта через его эндпоинт публикации: не более шести в минуту.

Что нужно планировщику от API?

Пять вещей: место для загрузки файлов, вызов, который ставит пост в очередь одного аккаунта, очередь, которая публикует вовремя, способ изменить решение и сведения о том, что произошло. API постов даёт каждое из них по тому же ключу ec_live_, что подключает ваших клиентов, поэтому календарь, процесс согласования и редактор остаются в вашем продукте.

1UploadPOST /media, or a public HTTPS link
2SchedulePOST /channels/:id/posts with publish_at
3HoldMedia copied, the post waits in the queue
4PublishThe network's official API, at the set time
5ReportStatus on GET /posts; post.published or post.failed

Как запланировать пост?

Один 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.
Schedule an Instagram carousel
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 ГБ для видео отклоняются уже тогда, а не в утро публикации.

Что может нести пост каждой сети?

Очередь проверяет каждый пост по правилам сети до его принятия. Пост, который их нарушает, отклоняется с сообщением, в котором названо правило, чтобы ваш редактор мог показать проблему, пока пользователь ещё редактирует. Каждая сеть принимает:

InstagramOne JPEG, a carousel of 2 to 10 items, a Reel or a Story; up to 2,200 characters; no link.
FacebookText, a link, one image or one video on a Page, never a link and a file together.
TikTokOne video, or 1 to 35 JPEG or WebP images with a title of up to 90 characters.
LinkedInText of up to 3,000 characters with one image or a titled link; no video.

Через какие статусы проходит пост?

Шесть, которые сообщают 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

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 днями бесплатно.

Читайте дальше

API соцсетей для агентств: ведите аккаунты клиентов из собственного ПОAPI для агентств: подключайте аккаунты клиентов по ссылке, помечайте их id клиента, публикуйте после одобрения, направляйте ответы и собирайте отчёты.Архитектура SaaS с ИИ-агентом: как охватить клиентов ваших клиентов в WhatsApp, Instagram и TikTokАрхитектура SaaS с ИИ-агентом, который отвечает клиентам ваших клиентов: подключения, приём событий, хранилище диалогов, воркер агента и исходящие отправки.Собственная разработка или покупка интеграций с соцсетями: API Meta, TikTok, YouTube и LinkedIn для вашего SaaSЧто требует собственная интеграция Meta, TikTok, YouTube и LinkedIn: проверки доступа, обновление токенов, вебхуки и мониторинг, против партнёрского API.Как узнать, что подключение клиента к WhatsApp или соцсети отключилосьСобытия connection.* и channel.*: тело запроса, причины вроде PRIMARY_INACTIVITY, X-EC-Signature, повторы около 33 часов и дедупликация по id.Публикация в Instagram, TikTok, Facebook, YouTube и LinkedIn через один APIПубликуйте и планируйте посты в Instagram, Reels, Stories, видео TikTok, YouTube и LinkedIn из Claude, ChatGPT или кода.Планирование публикаций в соцсетях с ИИ в Claude или ChatGPTПопросите Claude или ChatGPT запланировать посты в Instagram, TikTok, LinkedIn и Facebook через очередь easyCoexistence на 90 дней вперёд, а в YouTube напрямую.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на