AccediInizia la prova gratuita
easyCoexistence API ufficiali

Come costruire uno scheduler per i social media con un'API: coda, media e stati dei post

Per costruire uno scheduler social con l'API Partner di easyCoexistence, il tuo backend invia ogni post a POST /channels/:id/posts con testo, media e un publish_at da 1 minuto fino a 90 giorni prima. easyCoexistence copia subito i media e pubblica il post all'orario previsto su Instagram, Facebook, TikTok o LinkedIn, segnalando ogni passaggio come stato e tramite gli eventi post.published e post.failed.

90 days

Fino a quanto in anticipo l'API dei post pianifica su Instagram, Facebook, TikTok e LinkedIn; il primo orario possibile è tra 1 minuto.

30 MB and 1 GB

Immagine più grande e video più grande che easyCoexistence copia al momento della pianificazione; un file più grande viene rifiutato in quel momento.

5 min, 30 min, 2 h

Quando un post limitato dalla rete per limiti di frequenza viene riprovato, prima di essere segnato come fallito.

100 posts

Post via API che un account Instagram può pubblicare in 24 ore mobili; un carosello conta come uno.

15 a day

Il limite di TikTok sui post video per account tramite il suo endpoint di pubblicazione, con al massimo sei in un minuto.

Di cosa ha bisogno uno scheduler dall'API?

Cinque cose: un punto dove caricare i file, una chiamata che mette in coda un post per un account, una coda che pubblica in orario, un modo per cambiare idea e un riscontro su cosa è successo. L'API dei post offre tutte queste funzioni con la stessa chiave ec_live_ che collega i tuoi clienti, così il calendario, il flusso di approvazione e il compositore restano nel tuo prodotto.

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

Come si pianifica un post?

Con una richiesta POST per account a https://easycoexistence.com/api/v1/channels/:id/posts, dove :id è il channel_id della sessione di connessione del cliente. publish_at è in formato ISO 8601 con Z o un offset; omettilo per pubblicare subito. La risposta è 201 con il post, oppure 422 quando un post da pubblicare subito non va a buon fine. L'header Idempotency-Key viene rispettato, quindi una richiesta ripetuta dopo un timeout non mette in coda il post due volte. Il corpo accetta:

  • text: la didascalia, il messaggio o il commento; media: un elenco di {url, type} oppure {media_id}.
  • link: un post con link su Facebook o un articolo LinkedIn, con un titolo su LinkedIn.
  • ig_type: IMAGE, CAROUSEL, REELS o STORIES, dedotto dai media quando viene omesso.
  • title e disable_comment per i post foto di TikTok; image_alt per un'immagine 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"
  }'

Come gestisce i media lo scheduler?

Con un link o con un caricamento. Un link HTTPS pubblico va direttamente in media; un file caricato dai tuoi utenti va su POST /media, come corpo della richiesta con il suo Content-Type e Content-Length, oppure come {"url"}, e il media_id restituito va nel post. Quando un post viene pianificato, easyCoexistence copia i suoi file, quindi il tuo link deve funzionare solo in quel momento. Una pagina web al posto di un file, un 404, il tipo sbagliato o un file oltre 30 MB per le immagini o 1 GB per i video vengono rifiutati già allora, non la mattina della pubblicazione.

Cosa può contenere il post di ciascuna rete?

La coda controlla ogni post con le regole della rete prima di accettarlo, e un post che ne viola una viene rifiutato con un messaggio che nomina la regola, così il tuo compositore può mostrare il problema mentre l'utente sta ancora modificando. Ogni rete accetta:

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.

Quali stati attraversa un post?

Sei stati, che GET /posts/:id e GET /posts riportano insieme a publish_at, al link del post una volta online e all'errore della rete quando è fallito:

  • scheduled: in coda, in attesa del suo orario.
  • publishing: consegnato alla rete.
  • processing: la rete sta ancora lavorando, come per un video TikTok o un container Instagram.
  • published: online, con il suo link.
  • failed: rifiutato o non confermato; may_be_published segnala un post che la rete potrebbe aver ricevuto.
  • canceled: rimosso prima dell'invio, da te o perché il suo canale è stato rimosso o sospeso.

Come si modifica, annulla o riprova un post?

PATCH /posts/:id cambia l'orario o il testo di un post programmato, e il titolo di un post foto TikTok; per cambiare i media, annullalo e programmane uno nuovo. DELETE /posts/:id lo annulla. POST /posts/:id/retry pubblica di nuovo subito un post fallito. Un post limitato dalla rete per limiti di frequenza viene riprovato da solo dopo 5 minuti, 30 minuti e 2 ore, mentre un post segnato may_be_published richiede un controllo dell'account prima di qualsiasi nuovo tentativo.

Come fa lo scheduler a sapere cosa è successo?

Dagli eventi e dalla lista. L'URL per gli eventi di stato impostato in Profile, Developers riceve post.published e post.failed, firmati con X-EC-Signature come ogni altro evento, con il post e il suo canale, così il tuo calendario può segnare ciascuno come online o segnalarlo. GET /posts accetta status, from, to e limit per le viste del calendario, e GET /channels/:id/posts elenca un solo account. Un post che fallisce in background invia anche un'e-mail al titolare dell'account, al massimo una volta ogni 3 ore per canale.

Come si inseriscono i post LinkedIn in uno scheduler?

Con una persona che approva ciascuno. I termini API di LinkedIn limitano l'uso delle sue API per automatizzare la pubblicazione, quindi uno scheduler tiene ogni post LinkedIn come bozza nel tuo prodotto finché una persona nominata non lo approva, poi lo invia con il suo publish_at. Regole ricorrenti, feed e importazioni in blocco dovrebbero puntare alle altre reti, lasciando a LinkedIn solo i post che qualcuno ha rivisto.

Errori comuni

  • Inviare publish_at senza offset. Un orario locale senza Z o offset viene rifiutato, quindi invia 2026-11-20T09:00:00-05:00 invece dell'orario semplice scelto dall'utente.
  • Riprovare subito un post segnato may_be_published. La rete potrebbe già mostrarlo, quindi controlla prima l'account, altrimenti il post esce due volte.
  • Ripetere una POST scaduta senza Idempotency-Key. Dai a ogni post una sua chiave, così una richiesta ripetuta restituisce il post già in coda invece di pianificare una seconda copia.
  • Usare file PNG per Instagram. L'API di pubblicazione di Instagram accetta solo JPEG, e il post viene rifiutato al momento della pianificazione, quindi converti le immagini nel passaggio di caricamento.
Farlo con EasyCoexistence

easyCoexistence offre al tuo scheduler un'unica coda per gli account Instagram, Facebook, TikTok e LinkedIn dei tuoi clienti, e altri canali, tramite le API ufficiali di ciascuna rete: media copiati al momento della pianificazione, sei stati, nuovi tentativi per i limiti di frequenza ed eventi post firmati, con ogni connessione monitorata 24/7. Da US$ 9 a US$ 0.75 per connessione al mese, che scende man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

Una sola richiesta può pianificare un post su più reti?

Ogni richiesta si rivolge a un solo canale, quindi inviane una per account, ciascuna con il proprio Idempotency-Key, e adatta il testo ai limiti di ciascuna rete.

L'API dei post pianifica anche i video YouTube?

YouTube pianifica in modo nativo. Carica il video tramite l'API di YouTube come privato con publishAt, usando il token di GET /channels/:id?credentials=1, e YouTube lo rende pubblico a quell'ora.

I tuoi utenti possono vedere i post programmati nella dashboard di easyCoexistence?

La schermata Posts appartiene al tuo account, quindi il tuo team vi vede Needs attention, Coming up e Published, con Cancel, Retry e Dismiss. I tuoi utenti vedono il calendario che il tuo prodotto costruisce a partire da GET /posts.

Quanto costa easyCoexistence per uno scheduler social?

Da US$ 9 a US$ 0.75 per account connesso al mese, con prezzo che scende man mano che i tuoi utenti ne collegano di più, con la pianificazione inclusa e i primi 3 giorni di prova gratuita.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il