Mendapatkan pekerjaan unggahan massal

Melaporkan pekerjaan yang dibuat oleh POST /social/bulk-posts. Lakukan polling hingga status mencapai nilai terminal, lalu baca results[] untuk mengetahui hasil setiap baris.

Kasus penggunaan: merekonsiliasi pemuatan massal dengan kalender Anda sendiri. Setelah mengirim satu batch, lakukan polling ke endpoint ini setiap beberapa detik. Saat status mencapai status terminal, telusuri results[] dan cocokkan clientReference dari setiap entri dengan catatan Anda sendiri, lalu tuliskan socialPostId pada catatan tersebut. Baris dengan status: "FAILED" memuat alasannya dalam errors[]; kirim ulang hanya baris tersebut dalam batch baru.

Kasus penggunaan: bilah kemajuan. Perbandingan processedCount dengan totalCount sudah cukup untuk menggerakkan bilah kemajuan tanpa perlu menelusuri results[] sama sekali, dan successCount / failureCount memberikan ringkasan utama segera setelah pekerjaan selesai.

Status pekerjaan

Catatan.

• clientReference adalah apa pun yang Anda kirim pada baris tersebut, yang dikembalikan apa adanya. Ini merupakan penghubung paling langsung ke data Anda sendiri; index, yaitu posisi baris berbasis 0 dalam array yang Anda kirim, menjadi alternatif jika Anda tidak mengirim nilai tersebut.
• Baris yang mencapai status: "CREATED" berarti unggahan sudah ada, bukan berarti unggahan tersebut sudah dipublikasikan — postStatus menunjukkan tahap unggahan itu sendiri. Baris PUBLISH dan SCHEDULE masih akan melalui alur publikasi asinkron setelahnya: gunakan setiap socialPostId pada GET /social/posts/{postId} dan baca channels[] untuk mengetahui hasil sebenarnya per kanal.
• Pekerjaan yang semua barisnya gagal validasi tidak akan pernah dibuat sama sekali, karena pembuatan massal menolak batch sebelum memasukkannya ke antrean. Pekerjaan FAILED di sini berarti pekerjaan mengalami kegagalan setelah diterima.
• updatedAt berubah seiring pemrosesan baris; nilainya menjadi tetap setelah pekerjaan mencapai status terminal.