Statusul containerului media Instagram: codurile și ciclul de viață
API-ul Instagram publică prin containere media, iar fiecare raportează un status_code: IN_PROGRESS cât timp este încă în procesul de publicare, FINISHED când este gata, PUBLISHED după ce este live, ERROR dacă nu a reușit să se finalizeze și EXPIRED dacă au trecut 24 de ore fără publicare. Meta recomandă verificarea o dată pe minut, timp de cel mult 5 minute.
easyCoexistence rulează ciclul containerului în interiorul publish_instagram_post: creează containerul, așteaptă ca Instagram să termine și publică, iar cât timp un videoclip este încă procesat, publicarea se finalizează de la sine.
Valorile pe care le poate lua status_code: IN_PROGRESS, FINISHED, PUBLISHED, ERROR și EXPIRED.
Cât timp poate un container să aștepte nepublicat până când statusul devine EXPIRED.
Intervalul sugerat de Meta între verificările statusului, pentru cel mult 5 minute.
Containerele pe care le poate crea un cont Instagram într-un interval glisant de 24 de ore.
Subcodul de eroare, sub codul 9007, pentru publicarea unui container care nu este încă gata.
Ce este un container media?
Obiectul din care se publică o postare. POST /<IG_ID>/media creează unul dintr-un URL de imagine sau video, Meta preia și pregătește media, iar POST /<IG_ID>/media_publish cu ID-ul containerului ca creation_id îl transformă într-o postare. Un carusel adaugă un nivel: câte un container pentru fiecare element, apoi un container CAROUSEL care le listează ca elemente copil.
Ce înseamnă fiecare cod de status?
GET /<IG_CONTAINER_ID>?fields=status_code returnează una dintre cele cinci valori, fiecare cu propriul pas următor:
IN_PROGRESS: containerul este încă în procesul de publicare; așteptați și verificați din nou.- FINISHED: containerul și media sunt gata; publicați-l.
- PUBLISHED: media este deja live; nu mai rămâne nimic de publicat.
- ERROR: containerul nu a reușit să finalizeze procesul de publicare; câmpul status conține un subcod de eroare cu motivul și este nevoie de un container nou.
- EXPIRED: nu a fost publicat în 24 de ore; creați unul nou.
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code
{
"status_code": "FINISHED",
"id": "<IG_CONTAINER_ID>"
}Cât de des trebuie verificat statusul?
O dată pe minut, timp de cel mult 5 minute, este recomandarea Meta. Verificarea contează cel mai mult la videoclipuri, deoarece Meta precizează că încărcările video sunt asincrone: primirea unui ID de container nu garantează că încărcarea a reușit, iar un status_code FINISHED este cel care o confirmă.
Ce se întâmplă dacă publicați prea devreme?
media_publish eșuează cu codul 9007, subcodul 2207027: media nu este pregătită pentru publicare. Nimic din cerere nu trebuie corectat; verificați statusul și publicați odată ce apare FINISHED. Codul 24 cu subcodul 2207008 este diferit: un container care nu există sau a expirat, iar Meta sugerează să reîncercați o dată sau de două ori, între 30 de secunde și 2 minute, înainte de a crea un container nou.
Cât timp rămâne valabil un container?
24 de ore. Un container care nu este publicat în acest interval are statusul EXPIRED și nu mai poate fi publicat, iar codul -2 cu subcodul 2207020, media a expirat, cere și el un container nou. Un cont poate crea 400 de containere într-un interval glisant de 24 de ore, ceea ce lasă loc să creați din nou unul după o eroare.
Ce mai raportează un container?
Încă două câmpuri și o notă de la publicare. status conține un subcod de eroare ori de câte ori status_code are valoarea ERROR. copyright_check_status arată, pentru un videoclip, dacă a rulat verificarea drepturilor de autor a Meta și dacă a găsit potriviri. După publicare, media_publish poate returna config_issue, CAPTION_NOT_ATTACHED sau USER_TAGGING_FAILURE, atunci când postarea a fost publicată fără legenda sau etichetările utilizatorilor.
Greșeli frecvente
- Tratarea unui ID de container ca pe o încărcare finalizată. Încărcările video sunt asincrone, iar doar un status_code FINISHED confirmă că media este gata.
- Publicarea cât timp statusul arată IN_PROGRESS. Apelul eșuează cu subcodul 2207027 până când statusul devine FINISHED.
- Păstrarea unui container peste o zi. După 24 de ore nepublicat, statusul devine EXPIRED, iar doar un container nou poate fi publicat.
- Citirea doar a status_code la o eroare. Când arată ERROR, câmpul status conține subcodul care numește cauza.
Claude, ChatGPT sau propriul cod primesc ID-ul media publicat sau o stare de procesare cât timp easyCoexistence o finalizează. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, cu scădere pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Ce înseamnă IN_PROGRESS pe un container Instagram?
Meta încă pregătește media. Așteptați și verificați din nou, deoarece publicarea înainte ca statusul să fie FINISHED eșuează cu codul 9007.
Câte containere media poate crea un cont Instagram?
400 într-un interval glisant de 24 de ore, ceea ce lasă loc să creați din nou un container după o eroare.
Ce înseamnă config_issue după publicare?
media_publish a reușit, dar postarea a fost publicată fără legenda, CAPTION_NOT_ATTACHED, sau fără etichetările utilizatorilor, USER_TAGGING_FAILURE.
De ce s-a încheiat containerul meu cu ERROR?
Nu a reușit să finalizeze procesul de publicare. Câmpul status conține un subcod de eroare cu motivul; remediați cauza și creați un container nou.
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