AccediInizia la prova gratuita
easyCoexistence API ufficiali

Stato dei media container Instagram: i codici e il ciclo di vita

L'API di Instagram pubblica tramite media container, e ognuno riporta uno status_code: IN_PROGRESS mentre è ancora nel processo di pubblicazione, FINISHED quando è pronto, PUBLISHED una volta online, ERROR se non è stato completato ed EXPIRED se sono passate 24 ore senza pubblicazione. Meta consiglia di controllarlo una volta al minuto, per non più di 5 minuti.

easyCoexistence gestisce il ciclo del container dentro publish_instagram_post: crea il container, attende che Instagram finisca e pubblica; se un video è ancora in elaborazione, termina la pubblicazione da solo.

5

Valori che può assumere status_code: IN_PROGRESS, FINISHED, PUBLISHED, ERROR ed EXPIRED.

24 hours

Quanto tempo un container può restare non pubblicato prima che lo stato diventi EXPIRED.

1 min

Intervallo suggerito da Meta tra i controlli di stato, per non più di 5 minuti.

400

Container che un account Instagram può creare in un periodo mobile di 24 ore.

2207027

Sottocodice di errore, sotto il codice 9007, per la pubblicazione di un container non ancora pronto.

Che cos'è un media container?

L'oggetto da cui viene pubblicato un post. POST /<IG_ID>/media ne crea uno da un URL di immagine o video, Meta recupera e prepara il contenuto, e POST /<IG_ID>/media_publish con l'ID del container come creation_id lo trasforma in un post. Un carosello aggiunge un livello: un container per ogni elemento, poi un container CAROUSEL che li elenca come figli.

Che cosa significa ogni codice di stato?

GET /<IG_CONTAINER_ID>?fields=status_code restituisce uno dei cinque valori, ognuno con il proprio passo successivo:

  • IN_PROGRESS: il container è ancora nel processo di pubblicazione; attendi e controlla di nuovo.
  • FINISHED: il container e il suo contenuto sono pronti; pubblicalo.
  • PUBLISHED: il contenuto è già online; non resta nulla da pubblicare.
  • ERROR: il container non ha completato il processo di pubblicazione; il campo status contiene un sottocodice di errore con il motivo, ed è necessario un nuovo container.
  • EXPIRED: non è stato pubblicato entro 24 ore; creane uno nuovo.
Checking a container's status
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code

{
  "status_code": "FINISHED",
  "id": "<IG_CONTAINER_ID>"
}

Ogni quanto controllare lo stato?

Una volta al minuto, per non più di 5 minuti, è la raccomandazione di Meta. Il controllo conta soprattutto per i video, perché Meta segnala che il caricamento dei video è asincrono: ricevere un ID container non garantisce che il caricamento sia riuscito, e solo uno status_code FINISHED lo conferma.

Che cosa succede se pubblichi troppo presto?

media_publish fallisce con il codice 9007, sottocodice 2207027: il contenuto non è pronto per la pubblicazione. Nella richiesta non c'è nulla da correggere; controlla lo stato e pubblica quando indica FINISHED. Il codice 24 con sottocodice 2207008 è diverso, indica un container che non esiste o è scaduto, e Meta suggerisce di riprovare una o due volte tra 30 secondi e 2 minuti prima di creare un nuovo container.

Quanto dura un container?

24 ore. Un container non pubblicato entro questo tempo risulta EXPIRED e non può più essere pubblicato; anche il codice -2 con sottocodice 2207020, il contenuto è scaduto, richiede un nuovo container. Un account può creare 400 container in un periodo mobile di 24 ore, il che lascia spazio per crearne uno nuovo dopo un errore.

Che altro riporta un container?

Altri due campi e una nota dalla pubblicazione. status contiene un sottocodice di errore ogni volta che status_code indica ERROR. copyright_check_status indica, per un video, se il controllo copyright di Meta è stato eseguito e se ha trovato corrispondenze. Dopo la pubblicazione, media_publish può restituire config_issue, CAPTION_NOT_ATTACHED o USER_TAGGING_FAILURE, quando il post va online senza la didascalia o senza i tag degli utenti.

Errori comuni

  • Trattare un ID container come un caricamento completato. I caricamenti video sono asincroni, e solo uno status_code FINISHED conferma che il contenuto è pronto.
  • Pubblicare mentre lo stato indica IN_PROGRESS. La chiamata fallisce con il sottocodice 2207027 finché non indica FINISHED.
  • Tenere un container per più di un giorno. Dopo 24 ore non pubblicato risulta EXPIRED, e si può pubblicare solo un nuovo container.
  • Leggere solo status_code in caso di errore. Quando indica ERROR, il campo status contiene il sottocodice che nomina la causa.
Farlo con EasyCoexistence

Claude, ChatGPT o il tuo codice ricevono l'ID del media pubblicato, oppure uno stato di elaborazione mentre easyCoexistence lo completa. Da US$ 9 a US$ 0,75 per connessione al mese, con il calo man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.

Domande frequenti

Che cosa significa IN_PROGRESS su un container Instagram?

Meta sta ancora preparando il contenuto. Attendi e controlla di nuovo, perché pubblicare prima che lo stato indichi FINISHED fallisce con il codice 9007.

Quanti media container può creare un account Instagram?

400 in un periodo mobile di 24 ore, il che lascia spazio per crearne un altro dopo un errore.

Che cosa significa config_issue dopo la pubblicazione?

media_publish è riuscito, ma il post è andato online senza la didascalia, CAPTION_NOT_ATTACHED, o senza i tag degli utenti, USER_TAGGING_FAILURE.

Perché il mio container è finito in ERROR?

Non ha completato il processo di pubblicazione. Il suo campo status contiene un sottocodice di errore con il motivo; correggi quella causa e crea un nuovo container.

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