Periksa status unggahan foto massal

Memeriksa secara berkala status unggahan foto massal asinkron. Jika suatu batch cukup besar, tambahkan foto lokasi memprosesnya di latar belakang dan mengembalikan requestId dalam objek request sebagai pengganti media yang telah selesai diproses. Ukuran batch yang memicu pemrosesan ini ditentukan oleh konfigurasi di sisi server, bukan konstanta yang dipublikasikan, jadi tentukan alur yang sedang Anda jalani dengan memeriksa apakah request.requestId dikembalikan, bukan dengan menghitung gambar Anda sendiri. Periksa endpoint ini secara berkala menggunakan requestId tersebut hingga tugas mencapai status akhir.

Contoh penggunaan: memperbarui bilah kemajuan unggahan. Setelah mengunggah batch besar, periksa status setiap beberapa detik selama status bernilai PROCESSING. Setelah nilainya berubah menjadi SUCCESS atau ERROR, baca array photos untuk mengetahui hasil setiap gambar: setiap entri memuat mediaId yang dihasilkan (jika berhasil) beserta pasangan status/errorMessage agar Anda dapat menampilkan secara tepat file mana yang ditolak dan alasannya (dimensi salah, format tidak didukung, dll.), alih-alih menggagalkan seluruh batch.

Nilai status: PROCESSING (masih diproses: periksa lagi), SUCCESS (pemrosesan tugas telah selesai), ERROR (tugas itu sendiri gagal; periksa photos[].errorMessage).

status pada tugas hanya menunjukkan bahwa pemrosesan telah selesai, bukan bahwa setiap gambar berhasil diproses. Tugas dengan status SUCCESS masih dapat memuat foto yang ditolak, seperti pada contoh di atas. Setelah tugas tidak lagi berstatus PROCESSING, telusuri photos[] dan baca status serta errorMessage milik setiap entri untuk mengetahui gambar mana yang berhasil diunggah.

Hal yang perlu diperhatikan saat memeriksa status secara berkala: beri jeda antar pemeriksaan: loop yang terus-menerus memanggil endpoint ini tanpa jeda dapat dengan cepat memicu 429. Patuhi header Retry-After dan utamakan interval beberapa detik. requestId yang tidak dikenal atau sudah kedaluwarsa tidak akan memberikan hasil, jadi periksa hanya ID yang dikembalikan oleh panggilan unggahan terbaru.