Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Cara membina penjadual media sosial menggunakan API: baris gilir, media dan status siaran

Untuk membina penjadual media sosial pada Partner API easyCoexistence, backend anda menghantar setiap siaran ke POST /channels/:id/posts dengan teksnya, media dan publish_at dari 1 minit hingga 90 hari ke hadapan. easyCoexistence menyalin media serta-merta dan menerbitkan siaran pada masanya di Instagram, Facebook, TikTok atau LinkedIn, dan melaporkan setiap langkah sebagai status serta melalui acara post.published dan post.failed.

90 days

Sejauh mana API siaran menjadualkan siaran di Instagram, Facebook, TikTok dan LinkedIn; masa terawal ialah 1 minit dari sekarang.

30 MB and 1 GB

Imej terbesar dan video terbesar yang disalin easyCoexistence apabila siaran dijadualkan; fail yang lebih besar ditolak pada ketika itu.

5 min, 30 min, 2 h

Apabila siaran yang dihadkan kadar oleh rangkaian dicuba semula, sebelum ditandai gagal.

100 posts

Bilangan siaran yang diterbitkan melalui API yang boleh dibuat oleh akaun Instagram dalam tempoh 24 jam bergulir; carousel dikira sebagai satu.

15 a day

Had TikTok bagi siaran video setiap akaun melalui endpoint penerbitannya, dengan paling banyak enam dalam satu minit.

Apakah yang diperlukan penjadual daripada API?

Lima perkara: tempat untuk memuat naik fail, panggilan yang memasukkan siaran ke baris gilir bagi satu akaun, baris gilir yang menerbitkan mengikut masa, cara untuk menukar keputusan, dan pemberitahuan tentang apa yang berlaku. API siaran memberikan setiap satu daripadanya pada kunci ec_live_ yang sama yang menyambungkan pelanggan anda, supaya kalendar, aliran kelulusan dan penyusun kekal dalam produk anda.

1UploadPOST /media, or a public HTTPS link
2SchedulePOST /channels/:id/posts with publish_at
3HoldMedia copied, the post waits in the queue
4PublishThe network's official API, at the set time
5ReportStatus on GET /posts; post.published or post.failed

Bagaimana anda menjadualkan siaran?

Dengan satu POST bagi setiap akaun ke https://easycoexistence.com/api/v1/channels/:id/posts, dengan :id ialah channel_id daripada sesi sambungan pelanggan anda. publish_at ialah ISO 8601 dengan Z atau offset; tinggalkannya untuk menerbitkan sekarang. Jawapannya ialah 201 dengan siaran itu, atau 422 apabila siaran untuk sekarang gagal. Pengepala Idempotency-Key diterima, jadi permintaan yang diulang selepas tamat masa tidak akan memasukkan siaran dua kali ke baris gilir. Badan itu mengandungi:

  • text: kapsyen, mesej atau ulasan; media: senarai {url, type} atau {media_id}.
  • link: siaran pautan Facebook atau artikel LinkedIn, dengan tajuk di LinkedIn.
  • ig_type: IMAGE, CAROUSEL, REELS atau STORIES, dikesan daripada media jika ditinggalkan.
  • title dan disable_comment untuk siaran foto TikTok; image_alt untuk imej LinkedIn.
Schedule an Instagram carousel
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 penjadual mengendalikan media?

Sama ada melalui pautan atau muat naik. Pautan HTTPS awam terus masuk ke media; fail yang dimuat naik pengguna anda pergi ke POST /media, sebagai badan permintaan dengan Content-Type dan Content-Length, atau sebagai {"url"}, dan media_id yang dikembalikannya dimasukkan ke dalam siaran. Apabila siaran dijadualkan, easyCoexistence menyalin failnya, jadi pautan anda hanya perlu berfungsi ketika itu. Halaman web (bukan fail), 404, jenis yang salah, atau fail melebihi 30 MB untuk imej atau 1 GB untuk video akan ditolak pada ketika itu, bukan pada pagi siaran.

Apakah yang boleh dibawa oleh siaran setiap rangkaian?

Baris gilir menyemak setiap siaran dengan peraturan rangkaian sebelum menerimanya, dan siaran yang melanggar satu peraturan ditolak dengan mesej yang menamakan peraturan itu, supaya penyusun anda boleh menunjukkan masalah semasa pengguna masih menyunting. Setiap rangkaian menerima:

InstagramOne JPEG, a carousel of 2 to 10 items, a Reel or a Story; up to 2,200 characters; no link.
FacebookText, a link, one image or one video on a Page, never a link and a file together.
TikTokOne video, or 1 to 35 JPEG or WebP images with a title of up to 90 characters.
LinkedInText of up to 3,000 characters with one image or a titled link; no video.

Melalui status apakah sesebuah siaran bergerak?

Enam, yang GET /posts/:id dan GET /posts laporkan, bersama publish_at, pautan siaran sebaik ia aktif dan ralat rangkaian apabila ia gagal:

  • scheduled: dalam baris gilir, menunggu masanya.
  • publishing: diserahkan kepada rangkaian.
  • processing: rangkaian masih memprosesnya, seperti video TikTok atau kontena Instagram.
  • published: aktif, dengan pautannya.
  • failed: ditolak atau tidak disahkan; may_be_published menandakan siaran yang mungkin telah diterima oleh rangkaian.
  • canceled: dialih keluar sebelum disiarkan, oleh anda atau kerana salurannya dialih keluar atau digantung.

Bagaimana anda menyunting, membatalkan atau mencuba semula siaran?

PATCH /posts/:id menukar masa atau teks siaran yang dijadualkan, dan tajuk siaran foto TikTok; untuk menukar medianya, batalkan dan jadualkan yang baharu. DELETE /posts/:id membatalkannya. POST /posts/:id/retry menerbitkan semula siaran yang gagal, sekarang juga. Siaran yang dihadkan kadar oleh rangkaian dicuba semula secara automatik selepas 5 minit, 30 minit dan 2 jam, dan siaran yang ditandai may_be_published memerlukan semakan akaun sebelum sebarang percubaan semula.

Bagaimana penjadual anda mengetahui apa yang berlaku?

Daripada acara dan senarai. URL acara status yang ditetapkan di bawah Profile, Developers menerima post.published dan post.failed, ditandatangani dengan X-EC-Signature seperti setiap acara lain, dengan siaran dan salurannya, supaya kalendar anda boleh menandakan setiap satu sebagai aktif atau menandakannya untuk perhatian. GET /posts menerima status, from, to dan limit bagi paparan kalendar, dan GET /channels/:id/posts menyenaraikan satu akaun. Siaran yang gagal di latar belakang juga menghantar e-mel kepada pemilik akaun anda, paling banyak sekali bagi setiap saluran setiap 3 jam.

Bagaimana siaran LinkedIn sesuai dengan penjadual?

Dengan seseorang yang meluluskan setiap satu. Terma API LinkedIn menyekat penggunaan API-nya untuk mengautomasikan penyiaran, jadi penjadual menyimpan setiap siaran LinkedIn sebagai draf dalam produk anda sehingga seseorang yang dinamakan meluluskannya, kemudian menghantarnya dengan publish_at-nya. Peraturan berulang, suapan dan import pukal wajar disasarkan kepada rangkaian lain, dan biarkan LinkedIn untuk siaran yang telah disemak seseorang.

Kesilapan biasa

  • Menghantar publish_at tanpa offset. Masa tempatan tanpa Z atau offset ditolak, jadi hantar 2026-11-20T09:00:00-05:00 dan bukannya masa jam semata-mata yang dipilih pengguna anda.
  • Mencuba semula siaran yang ditandai may_be_published serta-merta. Rangkaian mungkin sudah memaparkannya, jadi semak akaun dahulu, atau siaran itu tersiar dua kali.
  • Mengulang POST yang tamat masa tanpa Idempotency-Key. Berikan setiap siaran kunci sendiri, supaya permintaan yang diulang mengembalikan siaran yang sudah dalam baris gilir dan bukannya menjadualkan salinan kedua.
  • Menggunakan pautan fail PNG untuk Instagram. API penerbitan Instagram hanya menerima JPEG, dan siaran itu ditolak apabila dijadualkan, jadi tukar imej dalam langkah muat naik anda.
Menggunakan EasyCoexistence untuk ini

easyCoexistence memberi penjadual anda satu baris gilir untuk akaun Instagram, Facebook, TikTok dan LinkedIn pelanggan anda, dan lebih banyak saluran, melalui API rasmi setiap rangkaian: media disalin apabila siaran dijadualkan, enam status, percubaan semula untuk had kadar dan acara siaran bertandatangan, dengan setiap sambungan dipantau 24/7. Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Bolehkah satu permintaan menjadualkan siaran pada beberapa rangkaian?

Setiap permintaan menyasarkan satu saluran, jadi hantar satu bagi setiap akaun, masing-masing dengan Idempotency-Key sendiri, dan sesuaikan teks mengikut had setiap rangkaian.

Adakah API siaran menjadualkan video YouTube?

YouTube menjadualkan secara asli. Muat naik video melalui API YouTube sebagai persendirian dengan publishAt, menggunakan token daripada GET /channels/:id?credentials=1, dan YouTube menjadikannya awam pada masa itu.

Bolehkah pengguna saya melihat siaran yang dijadualkan dalam dashboard easyCoexistence?

Skrin Posts ialah milik akaun anda, jadi pasukan anda melihat Needs attention, Coming up dan Published di situ, dengan Cancel, Retry dan Dismiss. Pengguna anda melihat kalendar yang dibina produk anda daripada GET /posts.

Berapa kos easyCoexistence untuk penjadual media sosial?

US$ 9 hingga US$ 0.75 bagi setiap akaun yang disambungkan sebulan, menurun apabila pengguna anda menyambungkan lebih banyak, dengan penjadualan disertakan dan 3 hari pertama percuma.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada