Instagram medya konteyneri durumu: kodlar ve yaşam döngüsü
Instagram API'si medya konteynerleri üzerinden yayın yapar ve her konteyner bir status_code bildirir: hâlâ yayın sürecindeyken IN_PROGRESS, yayına hazır olduğunda FINISHED, canlıya alındığında PUBLISHED, tamamlanamazsa ERROR, 24 saat yayınlanmadan geçerse EXPIRED. Meta, en fazla 5 dakika boyunca dakikada bir kontrol etmeyi önerir.
easyCoexistence, konteyner döngüsünü publish_instagram_post içinde yürütür: konteyneri oluşturur, Instagram'ın işi bitirmesini bekler ve yayınlar.
status_code'un alabileceği değerler: IN_PROGRESS, FINISHED, PUBLISHED, ERROR ve EXPIRED.
Konteynerin yayınlanmadan bekleyebileceği süre; bu süre dolunca durum EXPIRED olur.
Meta'nın durum kontrolleri için önerdiği aralık; en fazla 5 dakika boyunca.
Bir Instagram hesabının kayan 24 saat içinde oluşturabileceği konteyner sayısı.
Henüz hazır olmayan bir konteyneri yayınlamaya bağlı, 9007 koduna ait hata alt kodu.
Medya konteyneri nedir?
Bir gönderinin yayınlandığı nesne. POST /<IG_ID>/media bir görsel veya video URL'sinden konteyner oluşturur; Meta medyayı alır ve hazırlar. Ardından POST /<IG_ID>/media_publish çağrısında konteynerin kimliğini creation_id olarak vererek bunu bir gönderiye dönüştürürsünüz. Karusel gönderilerde bir düzey daha eklenir: her öğe için bir konteyner, ardından bunları alt öğe olarak listeleyen bir CAROUSEL konteyneri.
Her durum kodu ne anlama gelir?
GET /<IG_CONTAINER_ID>?fields=status_code beş değerden birini döndürür; her birinin kendi sonraki adımı vardır:
IN_PROGRESS: Konteyner hâlâ yayın sürecinde; bekleyin ve tekrar kontrol edin.- FINISHED: Konteyner ve medyası hazır; yayınlayın.
- PUBLISHED: Medya zaten canlı; yayınlanacak bir şey kalmadı.
- ERROR: Konteyner yayın sürecini tamamlayamadı; status alanı nedeni gösteren bir hata alt kodu içerir ve yeni bir konteyner gerekir.
- EXPIRED: 24 saat içinde yayınlanmadı; yeni bir tane oluşturun.
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code
{
"status_code": "FINISHED",
"id": "<IG_CONTAINER_ID>"
}Durum ne sıklıkla kontrol edilmeli?
Meta'nın önerisi, en fazla 5 dakika boyunca dakikada bir kontrol etmektir. Kontrol en çok video için önemlidir, çünkü Meta video yüklemelerinin eşzamansız olduğunu belirtir: bir konteyner kimliği almak yüklemenin başarılı olduğunu garanti etmez; bunu doğrulayan şey status_code değerinin FINISHED olmasıdır.
Çok erken yayınlarsanız ne olur?
media_publish, 9007 kodu ve 2207027 alt koduyla başarısız olur: medya yayına hazır değildir. İsteğte düzeltilmesi gereken bir şey yoktur; durumu kontrol edin ve FINISHED göründüğünde yayınlayın. 24 kodu ve 2207008 alt kodu ise farklıdır: var olmayan ya da süresi dolmuş bir konteynere işaret eder. Bu durumda Meta, yeni bir konteyner oluşturmadan önce 30 saniye ile 2 dakika arasında bir veya iki kez yeniden denemeyi önerir.
Bir konteyner ne kadar yaşar?
24 saat. Bu sürede yayınlanmayan bir konteynerin durumu EXPIRED olur ve artık yayınlanamaz. -2 kodu ve 2207020 alt kodu (medyanın süresi dolmuş) da yeni bir konteyner ister. Bir hesap kayan 24 saat içinde 400 konteyner oluşturabilir; bu, bir hatadan sonra yeniden bir tane oluşturmak için yer bırakır.
Bir konteyner başka neleri bildirir?
İki alan daha ve yayından bir not. status, status_code ERROR olduğunda bir hata alt kodu tutar. copyright_check_status, bir video için Meta'nın telif hakkı kontrolünün çalışıp çalışmadığını ve eşleşme bulup bulmadığını bildirir. Yayından sonra media_publish, gönderi açıklaması veya kullanıcı etiketleri olmadan canlıya çıktığında config_issue, CAPTION_NOT_ATTACHED veya USER_TAGGING_FAILURE döndürebilir.
Yaygın hatalar
- Konteyner kimliğini tamamlanmış bir yükleme sanmak. Video yüklemeleri eşzamansızdır ve yalnızca status_code değeri FINISHED olduğunda medyanın hazır olduğu doğrulanır.
- Durum IN_PROGRESS iken yayınlamak. Çağrı, durum FINISHED olana kadar 2207027 alt koduyla başarısız olur.
- Konteyneri bir günden fazla tutmak. 24 saat yayınlanmadan geçince durum EXPIRED olur ve yalnızca yeni bir konteyner yayınlanabilir.
- Başarısızlıkta yalnızca status_code okumak. ERROR olduğunda status alanı, nedeni adlandıran alt kodu taşır.
Bir video hâlâ işleniyorsa yayımlamayı kendi başına tamamlar. Claude, ChatGPT ya da kendi kodunuz, yayınlanan medya kimliğini ya da easyCoexistence tamamlarken bir işleme durumunu geri alır. Bağlantı başına aylık US$ 9'dan başlayıp bağlantı ekledikçe US$ 0,75'e kadar düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
IN_PROGRESS, bir Instagram konteynerinde ne anlama gelir?
Meta medyayı hâlâ hazırlıyor. Bekleyin ve tekrar kontrol edin; durum FINISHED olmadan yayınlamak 9007 koduyla başarısız olur.
Bir Instagram hesabı kaç medya konteyneri oluşturabilir?
Kayan 24 saat içinde 400 tane; bu, bir hatadan sonra yeniden konteyner oluşturmak için yer bırakır.
Yayından sonra config_issue ne anlama gelir?
media_publish başarılı oldu, ancak gönderi açıklaması olmadan (CAPTION_NOT_ATTACHED) ya da kullanıcı etiketleri olmadan (USER_TAGGING_FAILURE) canlıya çıktı.
Konteynerim neden ERROR durumunda bitti?
Yayın sürecini tamamlayamadı. status alanı nedeni gösteren bir hata alt kodu tutar; bu nedeni giderin ve yeni bir konteyner oluşturun.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi