Cum construiți un scheduler de social media pe un API: coada, media și statusurile postărilor
Pentru a construi un scheduler de social media pe Partner API-ul easyCoexistence, backend-ul dumneavoastră trimite fiecare post la POST /channels/:id/posts, cu textul, media și un publish_at de la 1 minut până la 90 de zile înainte. easyCoexistence copiază media imediat și publică postarea la ora sa pe Instagram, Facebook, TikTok sau LinkedIn, raportând fiecare etapă ca status și prin evenimentele post.published și post.failed.
Cât de departe în viitor programează API-ul de posturi pe Instagram, Facebook, TikTok și LinkedIn; cea mai apropiată oră este peste 1 minut.
Cea mai mare imagine și cel mai mare video pe care easyCoexistence le copiază la programarea unei postări; un fișier mai mare este refuzat pe loc.
Când o postare limitată de rețea din cauza ratei de solicitări este reîncercată, înainte de a fi marcată drept eșuată.
Postările publicate prin API pe care un cont Instagram le poate face într-o fereastră mobilă de 24 de ore; un carusel contează drept una.
Limita TikTok pentru postările video per cont prin endpoint-ul său de publicare, cu cel mult șase într-un minut.
De ce are nevoie un scheduler de la API?
Cinci lucruri: un loc în care să încărcați fișiere, un apel care pune în coadă o postare pentru un cont, o coadă care publică la timp, o cale de a-și schimba decizia și informarea despre ce s-a întâmplat. API-ul de posturi le oferă pe toate cu aceeași cheie ec_live_ care conectează clienții dumneavoastră, astfel încât calendarul, fluxul de aprobare și editorul rămân în produsul dumneavoastră.
Cum programați o postare?
Cu un POST pentru fiecare cont, la https://easycoexistence.com/api/v1/channels/:id/posts, unde :id este channel_id din sesiunea de conectare a clientului. publish_at este ISO 8601 cu Z sau cu un decalaj; lăsați-l necompletat pentru a publica imediat. Răspunsul este 201 cu postarea sau 422 când o postare pentru acum a eșuat. Antetul Idempotency-Key este respectat, astfel încât o cerere repetată după un timeout nu pune postarea în coadă de două ori. Corpul cererii conține:
- text: legenda, mesajul sau comentariul; media: o listă de {url, type} sau {
media_id}. - link: o postare cu link pe Facebook sau un articol LinkedIn, cu un titlu pe LinkedIn.
ig_type: IMAGE, CAROUSEL, REELS sau STORIES, deduse din media dacă lipsește.- title și
disable_commentpentru postările foto TikTok;image_altpentru o imagine 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"
}'Cum gestionează schedulerul media?
Fie prin link, fie prin încărcare. Un link HTTPS public intră direct în media; un fișier încărcat de utilizatori merge la POST /media, ca corp al cererii cu Content-Type și Content-Length, sau ca {"url"}, iar media_id returnat intră în postare. Când o postare este programată, easyCoexistence copiază fișierele, deci linkul dumneavoastră trebuie să funcționeze doar în acel moment. O pagină web în locul unui fișier, o eroare 404, tipul greșit sau un fișier de peste 30 MB pentru imagini ori 1 GB pentru videoclipuri sunt refuzate atunci, nu în dimineața postării.
Ce poate conține postarea fiecărei rețele?
Coada verifică fiecare postare în raport cu regulile rețelei înainte de a o accepta, iar o postare care încalcă o regulă este refuzată cu un mesaj care numește regula, astfel încât editorul dumneavoastră poate afișa problema cât utilizatorul încă editează. Fiecare rețea acceptă:
Prin ce statusuri trece o postare?
Șase, pe care GET /posts/:id și GET /posts le raportează, împreună cu publish_at, linkul postării odată ce este live și eroarea rețelei când a eșuat:
- scheduled: în coadă, în așteptarea orei sale.
- publishing: predată rețelei.
- processing: rețeaua încă lucrează la ea, ca în cazul unui videoclip TikTok sau al unui container Instagram.
- published: live, cu linkul său.
- failed: refuzată sau neconfirmată;
may_be_publishedmarchează una pe care rețeaua ar fi putut-o primi. - canceled: eliminată înainte de publicare, de dumneavoastră sau pentru că i-a fost eliminat ori suspendat canalul.
Cum editați, anulați sau reîncercați o postare?
PATCH /posts/:id schimbă ora sau textul unei postări programate și titlul unei postări foto TikTok; pentru a schimba media, anulați-o și programați una nouă. DELETE /posts/:id o anulează. POST /posts/:id/retry publică din nou o postare eșuată, acum. O postare limitată de rețea este reîncercată automat după 5 minute, 30 de minute și 2 ore, iar o postare marcată may_be_published necesită o verificare a contului înainte de orice reîncercare.
Cum află schedulerul ce s-a întâmplat?
Din evenimente și din listă. URL-ul pentru statusul evenimentelor, setat sub Profile, Developers, primește post.published și post.failed, semnate cu X-EC-Signature ca orice alt eveniment, cu postarea și canalul ei, astfel încât calendarul dumneavoastră să poată marca fiecare ca live sau să o semnaleze. GET /posts acceptă status, from, to și limit pentru vizualizările calendarului, iar GET /channels/:id/posts listează un singur cont. O postare care eșuează în fundal trimite și un e-mail proprietarului contului, cel mult o dată pe canal la fiecare 3 ore.
Cum se potrivesc postările LinkedIn într-un scheduler?
Cu o persoană care aprobă fiecare postare. Termenii API ai LinkedIn restricționează folosirea API-urilor sale pentru automatizarea publicării, deci un scheduler păstrează fiecare postare LinkedIn drept ciornă în produsul dumneavoastră până când o persoană numită o aprobă, apoi o trimite cu publish_at-ul ei. Regulile recurente, fluxurile și importurile în masă ar trebui să vizeze celelalte rețele, iar LinkedIn să rămână pentru postările revizuite de cineva.
Greșeli frecvente
- Trimiterea publish_at fără decalaj. O oră locală fără Z sau decalaj este refuzată, așa că trimiteți 2026-11-20T09:00:00-05:00 și nu ora simplă pe care a ales-o utilizatorul.
- Reîncercarea imediată a unei postări marcate may_be_published. Rețeaua o poate afișa deja, așa că verificați mai întâi contul, altfel postarea apare de două ori.
- Repetarea unui POST expirat fără Idempotency-Key. Dați fiecărei postări propria cheie, astfel încât o cerere repetată să returneze postarea deja pusă în coadă, nu să programeze o a doua copie.
- Legarea fișierelor PNG pentru Instagram. API-ul de publicare Instagram acceptă doar JPEG, iar postarea este refuzată la programare, deci convertiți imaginile în pasul de încărcare.
easyCoexistence oferă schedulerului dumneavoastră o singură coadă pentru conturile Instagram, Facebook, TikTok și LinkedIn ale clienților dumneavoastră și pentru alte canale, prin API-ul oficial al fiecărei rețele: media copiată la programarea unei postări, șase statusuri, reîncercări pentru limitele de rată și evenimente semnate pentru postări, cu fiecare conexiune monitorizată 24/7. US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Poate o singură cerere să programeze o postare pe mai multe rețele?
Fiecare cerere vizează un singur canal, deci trimiteți câte una pentru fiecare cont, fiecare cu propria Idempotency-Key, și adaptați textul la limitele fiecărei rețele.
API-ul de posturi programează videoclipuri YouTube?
YouTube programează nativ. Încărcați videoclipul prin API-ul YouTube ca privat, cu publishAt, folosind token-ul din GET /channels/:id?credentials=1, iar YouTube îl face public la acea oră.
Pot utilizatorii dumneavoastră să își vadă postările programate în dashboard-ul easyCoexistence?
Ecranul Posts aparține contului dumneavoastră, deci echipa dumneavoastră vede acolo Needs attention, Coming up și Published, cu Cancel, Retry și Dismiss. Utilizatorii dumneavoastră văd calendarul pe care îl construiește produsul dumneavoastră din GET /posts.
Cât costă easyCoexistence pentru un scheduler de social media?
US$ 9 până la US$ 0,75 pe cont conectat pe lună, scăzând pe măsură ce utilizatorii dumneavoastră conectează mai multe conturi, cu programarea inclusă și primele 3 zile gratuite.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la