MasukMulai uji coba gratis
easyCoexistence API resmi

Status media container Instagram: kode dan siklusnya

API Instagram menerbitkan lewat media container, dan masing-masing melaporkan status_code: IN_PROGRESS selama masih dalam proses publikasi, FINISHED saat siap, PUBLISHED setelah tayang, ERROR jika gagal diselesaikan dan EXPIRED jika 24 jam berlalu tanpa dipublikasikan. Meta menyarankan pengecekan setiap menit, selama tidak lebih dari 5 menit.

easyCoexistence menjalankan siklus container di dalam publish_instagram_post: membuat container, menunggu Instagram selesai dan mempublikasikannya, dan selagi video masih diproses, ia menyelesaikan publikasi dengan sendirinya.

5

Nilai yang dapat diambil status_code: IN_PROGRESS, FINISHED, PUBLISHED, ERROR dan EXPIRED.

24 hours

Berapa lama container dapat menunggu tanpa dipublikasikan sebelum statusnya berubah menjadi EXPIRED.

1 min

Interval pengecekan status yang disarankan Meta, selama tidak lebih dari 5 menit.

400

Jumlah container yang dapat dibuat akun Instagram dalam 24 jam bergulir.

2207027

Subkode kesalahan di bawah kode 9007, untuk mempublikasikan container yang belum siap.

Apa itu media container?

Objek tempat sebuah postingan dipublikasikan. POST /<IG_ID>/media membuat satu dari URL gambar atau video, Meta mengambil dan menyiapkan media, dan POST /<IG_ID>/media_publish dengan ID container sebagai creation_id mengubahnya menjadi postingan. Carousel menambah satu lapisan: satu container untuk setiap item, lalu container CAROUSEL yang mencantumkannya sebagai children.

Apa arti setiap kode status?

GET /<IG_CONTAINER_ID>?fields=status_code mengembalikan salah satu dari lima nilai, masing-masing dengan langkah berikutnya:

  • IN_PROGRESS: container masih dalam proses publikasi; tunggu lalu cek kembali.
  • FINISHED: container dan medianya sudah siap; publikasikan.
  • PUBLISHED: media sudah tayang; tidak ada yang perlu dipublikasikan lagi.
  • ERROR: container gagal menyelesaikan proses publikasi; field status berisi subkode kesalahan dengan alasannya, dan container baru diperlukan.
  • EXPIRED: tidak dipublikasikan dalam 24 jam; buat container baru.
Checking a container's status
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code

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

Seberapa sering status sebaiknya dicek?

Setiap menit, selama tidak lebih dari 5 menit, adalah rekomendasi Meta. Pengecekan paling penting untuk video, karena Meta mencatat bahwa unggahan video bersifat asinkron: menerima ID container tidak menjamin unggahan berhasil, dan status_code FINISHED-lah yang memastikannya.

Apa yang terjadi jika mempublikasikan terlalu cepat?

media_publish gagal dengan kode 9007, subkode 2207027: media belum siap untuk dipublikasikan. Tidak ada yang perlu diperbaiki di permintaan; periksa status dan publikasikan setelah bertuliskan FINISHED. Kode 24 dengan subkode 2207008 berbeda, yaitu container yang tidak ada atau sudah kedaluwarsa, dan Meta menyarankan mencoba kembali sekali atau dua kali dalam rentang 30 detik hingga 2 menit sebelum membuat container baru.

Berapa lama sebuah container bertahan?

24 jam. Container yang tidak dipublikasikan dalam waktu itu bertuliskan EXPIRED dan tidak lagi dapat dipublikasikan, dan kode -2 dengan subkode 2207020, media sudah kedaluwarsa, juga meminta container baru. Sebuah akun dapat membuat 400 container dalam 24 jam bergulir, yang masih menyisakan ruang untuk membuat ulang setelah kegagalan.

Apa lagi yang dilaporkan container?

Dua field lagi, serta catatan dari publikasi. status berisi subkode kesalahan setiap kali status_code bertuliskan ERROR. copyright_check_status melaporkan, untuk video, apakah pemeriksaan hak cipta Meta sudah berjalan dan apakah menemukan kecocokan. Setelah publikasi, media_publish dapat mengembalikan config_issue, CAPTION_NOT_ATTACHED atau USER_TAGGING_FAILURE, saat postingan tayang tanpa caption atau tanpa tag pengguna.

Kesalahan umum

  • Menganggap ID container sebagai unggahan yang selesai. Unggahan video bersifat asinkron, dan hanya status_code FINISHED yang memastikan media siap.
  • Mempublikasikan saat status masih IN_PROGRESS. Panggilan gagal dengan subkode 2207027 sampai statusnya FINISHED.
  • Menyimpan container lebih dari sehari. Setelah 24 jam tanpa dipublikasikan statusnya EXPIRED, dan hanya container baru yang dapat dipublikasikan.
  • Hanya membaca status_code saat gagal. Ketika bertuliskan ERROR, field status membawa subkode yang menyebut penyebabnya.
Melakukan ini dengan EasyCoexistence

Claude, ChatGPT, atau kode Anda sendiri menerima ID media yang sudah dipublikasikan, atau status pemrosesan selagi easyCoexistence menyelesaikannya. US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apa arti IN_PROGRESS pada container Instagram?

Meta masih menyiapkan media. Tunggu lalu cek kembali, karena mempublikasikan sebelum status bertuliskan FINISHED gagal dengan kode 9007.

Berapa banyak media container yang dapat dibuat akun Instagram?

400 dalam 24 jam bergulir, yang masih menyisakan ruang untuk membuat container lagi setelah kegagalan.

Apa arti config_issue setelah publikasi?

media_publish berhasil, tetapi postingan tayang tanpa caption, CAPTION_NOT_ATTACHED, atau tanpa tag pengguna, USER_TAGGING_FAILURE.

Mengapa container saya berakhir di ERROR?

Container gagal menyelesaikan proses publikasi. Field status berisi subkode kesalahan dengan alasannya; perbaiki penyebab itu lalu buat container baru.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada