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.
Jak daleko w przyszłość API postów planuje publikacje na Instagramie, Facebooku, TikToku i LinkedIn; najwcześniejszy czas to 1 minuta od teraz.
Największy obraz i największe wideo, jakie easyCoexistence kopiuje przy planowaniu posta; większy plik zostaje odrzucony w tym momencie.
Kiedy post, który sieć ograniczyła limitem, zostanie ponowiony, zanim zostanie oznaczony jako nieudany.
Posty publikowane przez API, jakie konto Instagrama może wykonać w ruchomym oknie 24 godzin; karuzela liczy się jako jeden.
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.
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_commentdla postów ze zdjęciami na TikToku;image_altdla obrazu na 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"
}'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:
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_publishedoznacza 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.
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