Membuat postingan secara massal

Membuat banyak postingan media sosial dalam satu permintaan. Baris dikirim dalam payload permintaan — tanpa unggahan file dan tanpa CSV, hanya array berisi objek yang sama dengan yang diterima POST /social/posts satu per satu. Maksimal 500 baris per permintaan.

Kasus penggunaan: memuat konten untuk satu kuartal dalam satu panggilan. Alat perencanaan Anda memiliki seluruh kalender konten klien. Buat satu baris per slot, tandai masing-masing dengan clientReference Anda sendiri, lalu kirim semuanya sekaligus. Batch tersebut akan berhasil sebagai satu kesatuan atau menunjukkan secara tepat baris mana yang perlu Anda perbaiki. Simpan job.id yang dikembalikan dan periksa GET /social/bulk-posts/{bulkJobId} secara berkala hingga status mencapai status akhir, lalu cocokkan setiap hasil berdasarkan clientReference-nya.

Seluruh batch divalidasi terlebih dahulu

Validasi dilakukan pada setiap baris sebelum apa pun dibuat, dan batch bersifat atomik pada tahap tersebut:

• Jika ada satu saja baris yang tidak valid, tidak ada apa pun yang dibuat. success bernilai false, SY95050 dikembalikan dalam error, dan setiap baris yang bermasalah muncul dalam job.results[] beserta index-nya yang dimulai dari 0, clientReference-nya, dan alasannya dalam errors[]. Perbaiki baris-baris tersebut dan kirim ulang seluruh batch.
• Jika setiap baris valid, sebuah tugas dimasukkan ke antrean, success bernilai true, dan Anda mendapatkan job.id. Setiap baris masih dapat gagal di kemudian waktu, ketika platform menolaknya saat publikasi; kegagalan tersebut akan ditampilkan pada tugas, bukan di sini.

Cocokkan hasil berdasarkan clientReference jika memungkinkan, dan berdasarkan index jika tidak — baris-baris itu sendiri tidak dikembalikan, sehingga kedua field tersebut adalah satu-satunya penghubung ke data Anda sendiri.

Catatan.

• Body permintaan harus dibungkus dalam objek input, dengan baris-baris di dalam input.posts.
• Periksa success, bukan status HTTP. Penolakan seluruh batch berupa HTTP 200 dengan success: false dan SY95050 dalam error.
• Maksimal 500 baris per permintaan. Array yang lebih besar langsung ditolak dengan SY95048 dan tidak ada apa pun yang dibuat; pecah array tersebut dan kirim dalam beberapa batch.
• Merek pada setiap baris ditentukan oleh socialProfileId. brandId hanya digunakan sebagai token jalur URL, dan rute ini sama sekali tidak memiliki token jalur.
• Baris dapat menargetkan merek yang berbeda. platforms pada setiap baris diperiksa terhadap merek pada baris itu sendiri, sehingga platform yang terhubung ke satu merek tetapi tidak ke merek lain hanya menyebabkan kegagalan pada baris yang memerlukannya.
• Setiap baris mengikuti aturan penjadwalan yang sama dengan satu postingan: scheduledAt atau scheduleDate + scheduleTime, tidak pernah keduanya, dan scheduleDate / scheduleTime dibaca dalam zona waktu merek pada baris tersebut. Kedua bentuk tersebut boleh digunakan pada baris yang berbeda dalam satu batch.
• Batas laju berlaku untuk permintaan, bukan untuk baris: batch berisi 500 baris menghabiskan satu permintaan dari kuota Anda. Lihat Batas laju.

Operasi tulis: tidak dijalankan pada akun aktif. Permintaan dan respons yang ditampilkan dibuat berdasarkan skema API; operasi ini memublikasikan ke akun media sosial sungguhan saat dijalankan.