Buat postingan media sosial

Membuat satu postingan untuk satu merek di satu atau beberapa akun media sosial yang terhubung ke merek tersebut. Panggilan yang sama mencakup ketiga siklus hidup: menyimpan DRAFT, memasukkan SCHEDULE ke antrean, atau langsung PUBLISH.

Kasus penggunaan: menjadwalkan kampanye dari kalender Anda sendiri. Aplikasi Anda sudah mengetahui apa yang ingin disampaikan klien dan kapan. Untuk setiap slot, panggil endpoint ini dengan action: "SCHEDULE" dan salah satu dari scheduledAt atau scheduleDate + scheduleTime, lalu kirim pengenal slot Anda sendiri sebagai clientReference agar Anda dapat mencocokkan data tanpa menyimpan UUID yang dikembalikan. Tampilkan entri sebagai tertunda hingga GET /social/posts/{postId} melaporkan bahwa postingan telah tayang di setiap kanal, dan sediakan tombol batal yang terhubung ke POST /social/posts/cancel.

Publikasi berlangsung secara asinkron

action: "PUBLISH" tidak memublikasikan postingan sebelum memberikan respons. Panggilan ini menerima postingan, mengembalikan socialPostId, lalu meneruskan postingan ke alur pemrosesan publikasi. Untuk mengetahui apa yang sebenarnya terjadi, periksa GET /social/posts/{postId} secara berkala dan baca array channels[] per kanal: status pada setiap entri adalah hasil untuk satu platform tersebut. Dalam permintaan yang sama, postingan dapat berhasil di Instagram dan gagal di LinkedIn, sehingga channels[] menjadi acuan sebenarnya dan status pada tingkat postingan merupakan ringkasan.

Memilih jadwal

action: "SCHEDULE" memerlukan tepat satu dari dua bentuk berikut, tidak boleh keduanya:

Mengirim keduanya, mengirim scheduleDate tanpa scheduleTime, atau mengirim scheduledAt tanpa offset akan ditolak dengan SY95046. DRAFT dan PUBLISH sama sekali tidak boleh menyertakan jadwal.

Catatan.

• Body permintaan harus dibungkus dalam objek input.
• Periksa success, bukan status HTTP. Kegagalan validasi dikembalikan sebagai HTTP 200 dengan success: false dan satu entri dalam array error untuk setiap masalah. Tidak ada yang dibuat ketika success bernilai false.
• Merek diidentifikasi dalam body sebagai socialProfileId. brandId hanya digunakan sebagai token pada path URL, tidak pernah sebagai field dalam body.
• Setiap platform dalam platforms harus sudah memiliki koneksi pada merek tersebut. Platform tanpa kanal aktif akan gagal dengan SY95045; baca koneksi merek terlebih dahulu, lalu arahkan pengguna melalui tautan koneksi untuk platform yang belum terhubung.
• Nilai platform adalah nama enum berhuruf kapital FACEBOOK, INSTAGRAM, TWITTER, LINKEDIN, PINTEREST. TWITTER adalah X; nilai tersebut tetap menggunakan nama lamanya, dan nilai berhuruf kecil akan ditolak.
• Instagram dan Pinterest tidak menerima postingan yang hanya berisi teks: sertakan setidaknya satu entri mediaUrls jika salah satunya ada dalam platforms.
• ID postingan berupa UUID biasa, bukan ID relay Base64 yang digunakan oleh postingan lokasi.
• Untuk membuat lebih dari beberapa postingan sekaligus, gunakan POST /social/bulk-posts, yang menerima struktur baris yang sama dan memvalidasi seluruh batch sebelum pemrosesan.

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