Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Jak zbudować harmonogram postów w mediach społecznościowych na API: kolejka, media i statusy postów

Aby zbudować harmonogram postów w mediach społecznościowych na Partner API easyCoexistence, Twój backend wysyła każdy post do POST /channels/:id/posts wraz z jego tekstem, mediami i publish_at od 1 minuty do 90 dni naprzód. easyCoexistence od razu kopiuje media i publikuje post o wyznaczonej porze na Instagramie, Facebooku, TikToku lub LinkedIn, zgłaszając każdy etap jako status oraz zdarzeniami post.published i post.failed.

90 days

Jak daleko w przyszłość API postów planuje publikacje na Instagramie, Facebooku, TikToku i LinkedIn; najwcześniejszy czas to 1 minuta od teraz.

30 MB and 1 GB

Największy obraz i największe wideo, jakie easyCoexistence kopiuje przy planowaniu posta; większy plik zostaje odrzucony w tym momencie.

5 min, 30 min, 2 h

Kiedy post, który sieć ograniczyła limitem, zostanie ponowiony, zanim zostanie oznaczony jako nieudany.

100 posts

Posty publikowane przez API, jakie konto Instagrama może wykonać w ruchomym oknie 24 godzin; karuzela liczy się jako jeden.

15 a day

Limit TikToka na posty wideo na konto przez jego endpoint publikacji, z maksymalnie sześcioma w ciągu minuty.

Czego harmonogram potrzebuje od API?

Pięć rzeczy: miejsce na wysyłanie plików, wywołanie dodające post do kolejki dla jednego konta, kolejkę publikującą o czasie, sposób na zmianę decyzji i informację o tym, co się stało. Posts API daje każdą z nich pod tym samym kluczem ec_live_, który łączy Twoich klientów, dzięki czemu kalendarz, przepływ akceptacji i edytor pozostają w Twoim produkcie.

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

Jak zaplanować post?

Jednym POST na konto pod adresem https://easycoexistence.com/api/v1/channels/:id/posts, gdzie :id to channel_id z sesji połączenia klienta. publish_at to ISO 8601 z Z lub przesunięciem; pomiń go, aby opublikować od razu. Odpowiedzią jest 201 z postem albo 422, gdy post przeznaczony na teraz się nie powiódł. Nagłówek Idempotency-Key jest respektowany, więc żądanie powtórzone po przekroczeniu czasu nie doda posta do kolejki dwukrotnie. Treść zawiera:

  • text: podpis, wiadomość lub komentarz; media: lista {url, type} albo {media_id}.
  • link: post z linkiem na Facebooku lub artykuł na LinkedIn, z tytułem na LinkedIn.
  • ig_type: IMAGE, CAROUSEL, REELS lub STORIES, wnioskowane z mediów, gdy zostanie pominięte.
  • title i disable_comment dla postów ze zdjęciami na TikToku; image_alt dla obrazu na 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"
  }'

Jak harmonogram obsługuje media?

Przez link albo przez wysłanie pliku. Publiczny link HTTPS trafia bezpośrednio do media; plik przesłany przez użytkownika idzie do POST /media, jako treść żądania z jego Content-Type i Content-Length, albo jako {"url"}, a zwrócony media_id wstawia się do posta. Gdy post zostaje zaplanowany, easyCoexistence kopiuje jego pliki, więc Twój link musi działać tylko w tym momencie. Strona internetowa zamiast pliku, błąd 404, zły typ albo plik większy niż 30 MB dla obrazów lub 1 GB dla wideo zostaną odrzucone właśnie wtedy, a nie rano w dniu publikacji.

Co może zawierać post w każdej sieci?

Kolejka sprawdza każdy post według zasad sieci, zanim go przyjmie, a post, który je łamie, zostaje odrzucony z komunikatem wskazującym zasadę. Dzięki temu Twój edytor może pokazać problem, gdy użytkownik jeszcze edytuje. Każda sieć przyjmuje:

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.

Przez jakie statusy przechodzi post?

Sześć, które GET /posts/:id i GET /posts zgłaszają razem z publish_at, linkiem do posta, gdy jest już opublikowany, oraz błędem sieci, gdy się nie powiódł:

  • scheduled: w kolejce, czeka na swój czas.
  • publishing: przekazany do sieci.
  • processing: sieć jeszcze nad nim pracuje, jak w przypadku wideo na TikToku lub kontenera Instagrama.
  • published: na żywo, z linkiem.
  • failed: odrzucony albo niepotwierdzony; may_be_published oznacza post, który sieć mogła otrzymać.
  • canceled: usunięty przed wysłaniem, przez Ciebie albo dlatego, że jego kanał został usunięty lub zawieszony.

Jak edytować, anulować lub ponowić post?

PATCH /posts/:id zmienia czas lub tekst zaplanowanego posta oraz tytuł posta ze zdjęciem na TikToku; aby zmienić media, anuluj go i zaplanuj nowy. DELETE /posts/:id anuluje post. POST /posts/:id/retry publikuje nieudany post ponownie, od razu. Post, który sieć ograniczyła limitem, zostaje ponowiony automatycznie po 5 minutach, 30 minutach i 2 godzinach, a post oznaczony may_be_published wymaga sprawdzenia konta przed jakąkolwiek ponowną próbą.

Skąd harmonogram dowiaduje się, co się stało?

Ze zdarzeń i z listy. Adres URL statusów ustawiony w Profile, Developers odbiera post.published i post.failed, podpisane X-EC-Signature jak każde inne zdarzenie, z postem i jego kanałem, dzięki czemu kalendarz oznaczy każdy jako opublikowany lub zgłosi go do sprawdzenia. GET /posts przyjmuje status, from, to i limit dla widoków kalendarza, a GET /channels/:id/posts wyświetla listę jednego konta. Post, który nie powiedzie się w tle, wysyła też e-mail do właściciela konta, najwyżej raz na kanał co 3 godziny.

Jak posty na LinkedIn pasują do harmonogramu?

Z osobą, która zatwierdza każdy z nich. Warunki API LinkedIn ograniczają używanie jego interfejsów do automatyzacji publikowania, więc harmonogram trzyma każdy post na LinkedIn jako szkic w Twoim produkcie, dopóki nazwana osoba go nie zatwierdzi, a następnie wysyła go z jego publish_at. Cykliczne reguły, kanały informacyjne i masowe importy powinny kierować się na pozostałe sieci, a LinkedIn zostawić postom, które ktoś przejrzał.

Typowe błędy

  • Wysyłanie publish_at bez przesunięcia. Czas lokalny bez Z ani przesunięcia zostaje odrzucony, więc wyślij 2026-11-20T09:00:00-05:00 zamiast samej godziny, którą wybrał użytkownik.
  • Ponowienie posta oznaczonego may_be_published od razu. Sieć może go już pokazywać, więc najpierw sprawdź konto, inaczej post wyjdzie dwukrotnie.
  • Powtarzanie POST, który przekroczył czas, bez Idempotency-Key. Nadaj każdemu postowi własny klucz, aby powtórzone żądanie zwróciło już dodany do kolejki post zamiast planować drugą kopię.
  • Linkowanie plików PNG dla Instagrama. API publikowania Instagrama przyjmuje wyłącznie JPEG, a post zostaje odrzucony w chwili zaplanowania, więc konwertuj obrazy w kroku wysyłania.
Z EasyCoexistence zrobisz to

easyCoexistence daje Twojemu harmonogramowi jedną kolejkę dla kont klientów na Instagramie, Facebooku, TikToku i LinkedIn oraz kolejne kanały, przez oficjalne API każdej sieci: media kopiowane przy planowaniu posta, sześć statusów, ponowienia przy limitach sieci i podpisane zdarzenia postów, a każde połączenie monitorowane przez 24/7. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.

Najczęściej zadawane pytania

Czy jedno żądanie może zaplanować post w kilku sieciach?

Każde żądanie dotyczy jednego kanału, więc wyślij po jednym na konto, każde z własnym Idempotency-Key, i dostosuj tekst do limitów każdej sieci.

Czy posts API planuje filmy na YouTube?

YouTube planuje natywnie. Wyślij film przez API YouTube jako prywatny z publishAt, używając tokenu z GET /channels/:id?credentials=1, a YouTube udostępni go publicznie o tym czasie.

Czy użytkownicy mogą widzieć zaplanowane posty w panelu easyCoexistence?

Ekran Posts należy do Twojego konta, więc Twój zespół widzi tam Needs attention, Coming up i Published, z przyciskami Cancel, Retry i Dismiss. Twoi użytkownicy widzą kalendarz, który Twój produkt buduje z GET /posts.

Ile kosztuje easyCoexistence jako harmonogram postów w mediach społecznościowych?

Od US$ 9 do US$ 0.75 za połączone konto miesięcznie, spadając wraz z połączeniami Twoich użytkowników, z planowaniem w cenie i pierwszymi 3 dniami za darmo.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w