Ditinjau 2026-11-11 · Versi API 2026-11-09 · Baca Markdown
Penerbitan dan penjadwalan
Sebuah posting AiVideoEditor memiliki draf berversi dan pengiriman independen untuk akun-akun terpilihnya. Penyimpanan draf bersifat permisif; penyimpanan yang berhasil tidak memastikan bahwa setiap tujuan dapat diterbitkan.
Menyiapkan posting
- Baca
/api/v1/accountsdan/api/v1/capabilitiesdengan kunci yang dimaksudkan. - Unggah dan finalisasi media yang diperlukan.
- Buat draf dengan
POST /api/v1/posts, atau edit denganPATCH /api/v1/posts/{id}. SertakanexpectedVersionterkini saat mengedit dan pertahankan versi yang dikembalikan. - Atur format tujuan dan penggantian varian eksplisit per akun bila diperlukan. Referensi API mendefinisikan field permintaan.
- Validasi dengan
POST /api/v1/posts/{id}/validate. HTTP 200 bisa berisivalid: false; periksa setiap isu sebelum mengirim. Akun tidak valid tidak dihapus secara diam-diam dari audiens.
Menerbitkan sekarang atau nanti
POST /posts/{id}/publish mengirimkan draf terkini. POST /posts/{id}/schedule
memerlukan scheduledAt, timezone dan expectedVersion. Waktu instan terjadwal
harus di masa depan dan dalam 90 hari. Simpan stempel waktu UTC ISO dan zona waktu
tampilan IANA terpisah; selesaikan ambiguitas waktu musim panas sebelum mengirim.
Gunakan Idempotency-Key yang berbeda untuk setiap mutasi baru. Pertahankan kunci tersebut
dan isi permintaan yang persis sama sebelum mengirim. Setelah timeout, putar ulang permintaan
identik dengan kunci yang sama. Ubah kunci hanya saat sengaja meminta operasi
baru. Pengeditan atau penjadwalan draf usang mengembalikan revision_conflict; baca ulang
dan tinjau konten terbaru alih-alih menimpanya secara membabi buta.
Respons 202 berarti diterima untuk pengiriman. Itu bukan bukti penerbitan.
Catat ID pengiriman dan amati GET /posts/{id} atau webhook pelanggan yang ditandatangani.
Gunakan polling berbatas dengan jeda yang meningkat; berhenti pada hasil terminal atau serah
terima kepada manusia alih-alih berputar tanpa henti.
Hasil per tujuan
Pengiriman dapat selesai secara independen. Satu tujuan mungkin terbit sementara yang lain
perlu sambung ulang atau persetujuan. Tampilkan setiap status dan tautan posting asli bila ada.
Coba ulang hanya kegagalan yang diketahui dan memenuhi syarat menggunakan POST /deliveries/{id}/retry.
Tujuan yang berhasil tidak boleh dibuat ulang untuk memulihkan tujuan yang gagal. Hasil
eksternal yang tidak diketahui perlu rekonsiliasi atau peninjauan, bukan pengiriman baru.
Batalkan dengan POST /deliveries/{id}/cancel selama pekerjaan masih belum diambil secara aman.
too_late_to_cancel berarti pengiriman telah melewati batas pembatalan yang aman;
itu tidak berarti posting eksternal telah dihapus.
Peninjauan manusia TikTok
Baca /accounts/{id}/tiktok/settings untuk pengaturan creator terkini dan pilihan
privasi yang tersedia. Pembacaan pengaturan atau penyimpanan draf tidak memberikan persetujuan.
consent_required menyertakan serah terima requiresAction yang aman ke komposer
terautentikasi. Orang yang berwenang meninjau video, takarir, dan tujuan secara persis
dan mengonfirmasi pilihan yang diwajibkan secara eksplisit di sana. Kunci produk dan alat MCP
tidak dapat mengonfirmasi atas namanya. Perubahan konten atau identitas memerlukan peninjauan baru.
Serah terima itu sendiri tidak memberikan keanggotaan atau akses.
Kontrol komposer
Gunakan Add media untuk mengunggah berkas atau memilih item pustaka yang ada. Takarir dibagi bersama hingga Customize content membuat varian khusus akun. Alat emoji dan hashtag menyisipkan teks biasa pada kursor.
Posting options mengelompokkan pengaturan akun terpilih. Pilihan wajib tetap terlihat; grup opsional tetap terlipat. Perubahan hanya berlaku untuk akun tersebut. Preview menampilkan draf efektif tanpa menyimpan atau mengirimkannya, termasuk draf yang belum lengkap; tampilan platform asli bisa berbeda.
Gunakan referensi aset privat untuk sampul dan thumbnail terjadwal. Alternatif URL publik harus tetap dapat dijangkau pada saat pengiriman. Konten subtitel disimpan bersama pengaturan yang tidak dapat diubah alih-alih bergantung pada berkas lokal sementara. Unggahan dokumen LinkedIn saat ini menerima PDF; format Office tetap dibatasi sampai validasi tanda tangan diimplementasikan.
Lihat referensi kemampuan untuk kontrol kanonik dan batasan integrasi. Perilaku format dan konfirmasi baru memerlukan migrasi basis data terkait sebelum deployment.