Cara membangun penjadwal media sosial dengan API: antrean, media, dan status postingan
Untuk membangun penjadwal media sosial dengan Partner API easyCoexistence, backend Anda mengirim setiap postingan ke POST /channels/:id/posts dengan teks, media, dan publish_at dari 1 menit hingga 90 hari ke depan. easyCoexistence langsung menyalin media dan menerbitkan postingan pada waktunya di Instagram, Facebook, TikTok, atau LinkedIn, lalu melaporkan setiap tahap sebagai status dan melalui event post.published dan post.failed.
Seberapa jauh ke depan API postingan menjadwalkan di Instagram, Facebook, TikTok, dan LinkedIn; waktu paling dekat adalah 1 menit lagi.
Gambar terbesar dan video terbesar yang disalin easyCoexistence saat postingan dijadwalkan; file yang lebih besar ditolak pada saat itu.
Saat postingan yang dibatasi lajunya oleh jaringan dicoba kembali, sebelum ditandai gagal.
Jumlah postingan API yang dapat dibuat akun Instagram dalam 24 jam bergulir; carousel dihitung sebagai satu.
Batas TikTok untuk postingan video per akun melalui endpoint publikasinya, dengan paling banyak enam dalam satu menit.
Apa yang dibutuhkan penjadwal dari API?
Lima hal: tempat mengunggah file, panggilan yang memasukkan postingan ke antrean untuk satu akun, antrean yang menerbitkan tepat waktu, cara mengubah keputusan, dan kabar tentang apa yang terjadi. Posts API memberikan semuanya dengan kunci ec_live_ yang sama yang menghubungkan pelanggan Anda, sehingga kalender, alur persetujuan, dan komposer tetap berada di produk Anda.
Bagaimana cara menjadwalkan postingan?
Dengan satu POST per akun ke https://easycoexistence.com/api/v1/channels/:id/posts, di mana :id adalah channel_id dari sesi koneksi pelanggan. publish_at berformat ISO 8601 dengan Z atau offset; kosongkan untuk menerbitkan sekarang. Responsnya 201 dengan postingan, atau 422 ketika postingan yang dimaksudkan untuk sekarang gagal. Header Idempotency-Key dihormati, sehingga permintaan yang diulang setelah timeout tidak memasukkan postingan dua kali ke antrean. Isi body berisi:
- text: caption, pesan, atau komentar; media: daftar {url, type} atau {
media_id}. - link: postingan tautan Facebook atau artikel LinkedIn, dengan judul di LinkedIn.
ig_type: IMAGE, CAROUSEL, REELS, atau STORIES, disimpulkan dari media jika tidak diisi.- title dan
disable_commentuntuk postingan foto TikTok;image_altuntuk gambar LinkedIn.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Idempotency-Key: campaign-311-ig" \
-H "Content-Type: application/json" \
-d '{
"text": "Three looks for the weekend",
"media": [
{ "url": "https://cdn.example.com/looks/1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/looks/2.jpg", "type": "image" }
],
"ig_type": "CAROUSEL",
"publish_at": "2026-11-20T09:00:00-05:00"
}'Bagaimana penjadwal menangani media?
Melalui tautan atau unggahan. Tautan HTTPS publik langsung masuk ke media; file yang diunggah pengguna dikirim ke POST /media, sebagai body permintaan dengan Content-Type dan Content-Length, atau sebagai {"url"}, dan media_id yang dikembalikan dimasukkan ke postingan. Saat postingan dijadwalkan, easyCoexistence menyalin filenya, sehingga tautan Anda hanya perlu berfungsi pada saat itu. Halaman web bukan file, 404, tipe yang salah, atau file lebih dari 30 MB untuk gambar atau 1 GB untuk video akan ditolak saat itu juga, bukan pada hari postingan tayang.
Apa yang dapat dimuat setiap postingan jaringan?
Antrean memeriksa setiap postingan terhadap aturan jaringan sebelum menerimanya, dan postingan yang melanggar satu aturan ditolak dengan pesan yang menyebutkan aturannya, sehingga komposer Anda dapat menampilkan masalahnya selagi pengguna masih menyunting. Setiap jaringan menerima:
Status apa saja yang dilalui postingan?
Enam, yang dilaporkan oleh GET /posts/:id dan GET /posts, bersama publish_at, tautan postingan setelah tayang, dan kesalahan jaringan ketika gagal:
- scheduled: dalam antrean, menunggu waktunya.
- publishing: diserahkan ke jaringan.
- processing: jaringan masih memprosesnya, seperti video TikTok atau container Instagram.
- published: tayang, dengan tautannya.
- failed: ditolak atau tidak terkonfirmasi;
may_be_publishedmenandai postingan yang mungkin sudah diterima jaringan. - canceled: dihapus sebelum terkirim, oleh Anda atau karena salurannya dihapus atau ditangguhkan.
Bagaimana cara menyunting, membatalkan, atau mencoba kembali postingan?
PATCH /posts/:id mengubah waktu atau teks postingan yang dijadwalkan, dan judul postingan foto TikTok; untuk mengubah medianya, batalkan lalu jadwalkan yang baru. DELETE /posts/:id membatalkannya. POST /posts/:id/retry menerbitkan kembali postingan yang gagal, sekarang juga. Postingan yang dibatasi lajunya oleh jaringan dicoba kembali secara otomatis setelah 5 menit, 30 menit, dan 2 jam, dan postingan yang ditandai may_be_published memerlukan pemeriksaan akun sebelum mencoba kembali apa pun.
Bagaimana penjadwal mengetahui apa yang terjadi?
Dari event dan dari daftar. URL event status yang diatur di Profile, Developers menerima post.published dan post.failed, ditandatangani dengan X-EC-Signature seperti event lainnya, berisi postingan dan salurannya, sehingga kalender Anda dapat menandai setiap postingan sebagai sudah tayang atau menandainya untuk diperiksa. GET /posts menerima status, from, to, dan limit untuk tampilan kalender, dan GET /channels/:id/posts mendaftar satu akun. Postingan yang gagal di latar belakang juga mengirim email kepada pemilik akun Anda, paling banyak sekali per saluran setiap 3 jam.
Bagaimana postingan LinkedIn cocok dengan penjadwal?
Dengan seseorang yang menyetujui setiap postingan. Ketentuan API LinkedIn membatasi penggunaan API-nya untuk mengotomasi pengiriman postingan, sehingga penjadwal menyimpan setiap postingan LinkedIn sebagai draf di produk Anda hingga orang yang disebutkan namanya menyetujuinya, lalu mengirimkannya dengan publish_at-nya. Aturan berulang, feed, dan impor massal sebaiknya ditujukan ke jaringan lain, dan LinkedIn dibiarkan untuk postingan yang sudah ditinjau seseorang.
Kesalahan umum
- Mengirim publish_at tanpa offset. Waktu lokal tanpa Z atau offset ditolak, jadi kirim 2026-11-20T09:00:00-05:00, bukan jam polos yang dipilih pengguna Anda.
- Mencoba kembali postingan yang ditandai may_be_published seketika. Jaringan mungkin sudah menampilkannya, jadi periksa akunnya terlebih dahulu, atau postingan itu terkirim dua kali.
- Mengulang POST yang timeout tanpa Idempotency-Key. Berikan kunci sendiri untuk setiap postingan, sehingga permintaan yang diulang mengembalikan postingan yang sudah masuk antrean, bukan menjadwalkan salinan kedua.
- Menautkan file PNG untuk Instagram. API publikasi Instagram hanya menerima JPEG, dan postingan ditolak saat dijadwalkan, jadi konversi gambar pada langkah unggah Anda.
easyCoexistence memberi penjadwal Anda satu antrean untuk akun Instagram, Facebook, TikTok, dan LinkedIn pelanggan Anda, serta saluran lainnya, melalui API resmi setiap jaringan: media disalin saat postingan dijadwalkan, enam status, percobaan ulang untuk pembatasan laju, dan event postingan yang ditandatangani, dengan setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah satu permintaan menjadwalkan postingan di beberapa jaringan?
Setiap permintaan menargetkan satu saluran, jadi kirim satu untuk setiap akun, masing-masing dengan Idempotency-Key sendiri, dan sesuaikan teks dengan batas setiap jaringan.
Apakah posts API menjadwalkan video YouTube?
YouTube menjadwalkan secara native. Unggah video melalui API YouTube sebagai private dengan publishAt, menggunakan token dari GET /channels/:id?credentials=1, dan YouTube menjadikannya publik pada waktu tersebut.
Bisakah pengguna saya melihat postingan terjadwal mereka di dashboard easyCoexistence?
Layar Posts menjadi milik akun Anda, sehingga tim Anda melihat Needs attention, Coming up, dan Published di sana, dengan Cancel, Retry, dan Dismiss. Pengguna Anda melihat kalender yang dibangun produk Anda dari GET /posts.
Berapa biaya easyCoexistence untuk penjadwal media sosial?
US$ 9 hingga US$ 0.75 per akun terhubung per bulan, turun seiring pengguna Anda menghubungkan lebih banyak, dengan penjadwalan termasuk dan 3 hari pertama gratis.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada