Hoe bouw je een planner voor sociale media op een API: de wachtrij, media en poststatussen
Om een planner voor sociale media te bouwen op de Partner API van easyCoexistence, stuurt je backend elke post naar POST /channels/:id/posts met de tekst, de media en een publish_at van 1 minuut tot 90 dagen vooruit. easyCoexistence kopieert de media meteen en publiceert de post op het ingestelde moment op Instagram, Facebook, TikTok of LinkedIn, en meldt elke stap als status en via de events post.published en post.failed.
Hoe ver vooruit de posts-API plant op Instagram, Facebook, TikTok en LinkedIn; het vroegste moment ligt 1 minuut vooruit.
Grootste afbeelding en grootste video die easyCoexistence kopieert bij het plannen van een post; een groter bestand wordt dan geweigerd.
Wanneer een post die een netwerk wegens een snelheidslimiet heeft geweigerd opnieuw wordt geprobeerd, voordat hij als mislukt geldt.
API-gepubliceerde posts die een Instagram-account kan maken in een lopende periode van 24 uur; een carrousel telt als één.
Het maximum van TikTok voor videoposts per account via zijn publicatie-endpoint, met maximaal zes per minuut.
Wat heeft een planner van de API nodig?
Vijf dingen: een plek om bestanden te uploaden, een aanroep die een post voor één account in de wachtrij zet, een wachtrij die op tijd publiceert, een manier om die planning te wijzigen en bericht over wat er is gebeurd. De posts-API biedt elk daarvan met dezelfde ec_live_-sleutel waarmee je klanten zich verbinden, zodat de agenda, de goedkeuringsstroom en de editor in je eigen product blijven.
Hoe plan je een post in?
Met één POST per account naar https://easycoexistence.com/api/v1/channels/:id/posts, waarbij :id de channel_id uit de connect-sessie van de klant is. publish_at is ISO 8601 met een Z of een offset; laat het weg om nu te publiceren. Het antwoord is 201 met de post, of 422 wanneer een post voor nu is mislukt. Een Idempotency-Key-header wordt gerespecteerd, dus een verzoek dat na een time-out wordt herhaald, plaatst de post niet twee keer in de wachtrij. De body bevat:
- text: het bijschrift, bericht of commentaar; media: een lijst van {url, type} of {
media_id}. - link: een Facebook-linkpost of een LinkedIn-artikel, met een titel op LinkedIn.
ig_type: IMAGE, CAROUSEL, REELS of STORIES, afgeleid uit de media als je het weglaat.- title en
disable_commentvoor TikTok-fotoposts;image_altvoor een LinkedIn-afbeelding.
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"
}'Hoe verwerkt de planner media?
Via een link of via een upload. Een publieke HTTPS-link gaat rechtstreeks in media; een bestand dat je gebruikers uploaden gaat naar POST /media, als body van het verzoek met zijn Content-Type en Content-Length, of als {"url"}, en de media_id die terugkomt gaat in de post. Wanneer een post wordt ingepland, kopieert easyCoexistence de bestanden, dus je link hoeft alleen op dat moment te werken. Een webpagina in plaats van een bestand, een 404, het verkeerde type of een bestand van meer dan 30 MB voor afbeeldingen of 1 GB voor video's wordt dan geweigerd, niet pas op de ochtend van de post.
Wat mag de post van elk netwerk bevatten?
De wachtrij controleert elke post op de regels van het netwerk voordat hij wordt aanvaard. Een post die een regel overtreedt, wordt geweigerd met een bericht dat de regel noemt, zodat je editor het probleem kan tonen terwijl de gebruiker nog bewerkt. Elk netwerk accepteert:
Welke statussen doorloopt een post?
Zes, die GET /posts/:id en GET /posts teruggeven, naast publish_at, de link van de post zodra hij live is en de fout van het netwerk wanneer hij mislukte:
- scheduled: in de wachtrij, wachtend op zijn moment.
- publishing: aangeboden aan het netwerk.
- processing: het netwerk werkt er nog aan, zoals bij een TikTok-video of een Instagram-container.
- published: live, met zijn link.
- failed: geweigerd of niet bevestigd;
may_be_publishedmarkeert een post die het netwerk mogelijk heeft ontvangen. - canceled: verwijderd voordat hij is verzonden, door jou of omdat zijn kanaal is verwijderd of geschorst.
Hoe bewerk, annuleer of herhaal je een post?
PATCH /posts/:id wijzigt het moment of de tekst van een geplande post, en de titel van een TikTok-fotopost; om de media te wijzigen annuleer je hem en plan je een nieuwe in. DELETE /posts/:id annuleert hem. POST /posts/:id/retry publiceert een mislukte post opnieuw, nu. Een post die een netwerk de snelheid heeft beperkt, wordt automatisch opnieuw geprobeerd na 5 minuten, 30 minuten en 2 uur. Een post met may_be_published vraagt om een controle van het account voordat je opnieuw probeert.
Hoe hoort de planner wat er is gebeurd?
Via events en via de lijst. De URL voor statusevents die je instelt onder Profile, Developers ontvangt post.published en post.failed, ondertekend met X-EC-Signature zoals elk ander event, met de post en zijn kanaal, zodat je agenda elke post als live kan markeren of als probleem kan aanduiden. GET /posts accepteert status, from, to en limit voor agendaweergaven, en GET /channels/:id/posts toont één account. Een post die op de achtergrond mislukt, mailt ook de eigenaar van je account, hoogstens één keer per kanaal per 3 uur.
Hoe passen LinkedIn-posts in een planner?
Met een persoon die elke post goedkeurt. De API Terms van LinkedIn beperken het gebruik van zijn API's om posts te automatiseren, dus een planner houdt elke LinkedIn-post als concept in je product tot een benoemde persoon hem goedkeurt, en plaatst hem daarna met zijn publish_at. Terugkerende regels, feeds en bulkimports moeten zich op de andere netwerken richten; laat LinkedIn over aan posts die iemand heeft nagekeken.
Veelgemaakte fouten
- publish_at zonder offset versturen. Een lokale tijd zonder Z of offset wordt geweigerd, dus stuur 2026-11-20T09:00:00-05:00 in plaats van de kale kloktijd die je gebruiker koos.
- Een post met may_be_published meteen opnieuw proberen. Het netwerk toont hem misschien al, dus controleer eerst het account, anders gaat de post twee keer uit.
- Een POST die in time-out is gegaan, herhalen zonder Idempotency-Key. Geef elke post een eigen sleutel, zodat een herhaald verzoek de al in de wachtrij geplaatste post teruggeeft in plaats van een tweede kopie in te plannen.
- PNG-bestanden koppelen voor Instagram. De publicatie-API van Instagram accepteert alleen JPEG, en de post wordt bij het plannen geweigerd, dus converteer afbeeldingen in je uploadstap.
easyCoexistence geeft je planner één wachtrij voor de Instagram-, Facebook-, TikTok- en LinkedIn-accounts van je klanten, en er komen meer kanalen bij, via de officiële API van elk netwerk: media gekopieerd bij het plannen, zes statussen, nieuwe pogingen bij snelheidslimieten en ondertekende postevents, met elke verbinding 24/7 bewaakt. US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.
Veelgestelde vragen
Kan één verzoek een post op meerdere netwerken plannen?
Elk verzoek richt zich op één kanaal, dus stuur er één per account, elk met een eigen Idempotency-Key, en pas de tekst aan op de limieten van elk netwerk.
Plant de posts-API YouTube-video's in?
YouTube plant zelf. Upload de video via de API van YouTube als privé met publishAt, met het token uit GET /channels/:id?credentials=1, en YouTube maakt hem op dat moment openbaar.
Kunnen mijn gebruikers hun geplande posts zien in het dashboard van easyCoexistence?
Het scherm Posts hoort bij je account, dus je team ziet daar Aandacht nodig, Komt eraan en Gepubliceerd, met Annuleren, Opnieuw proberen en Negeren. Je gebruikers zien de agenda die je product bouwt op basis van GET /posts.
Wat kost easyCoexistence voor een planner voor sociale media?
US$ 9 tot US$ 0.75 per verbonden account per maand, dalend naarmate je gebruikers meer accounts verbinden, met planning inbegrepen en de eerste 3 dagen als gratis proefperiode.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op