Bir API üzerinde sosyal medya zamanlayıcısı nasıl oluşturulur: kuyruk, medya ve gönderi durumları
easyCoexistence'ın Partner API'siyle sosyal medya zamanlayıcısı kurmak için arka ucunuz her gönderiyi metni, medyası ve 1 dakika ile 90 gün arasında bir publish_at değeriyle POST /channels/:id/posts adresine gönderir. easyCoexistence medyayı hemen kopyalar ve gönderiyi zamanında Instagram, Facebook, TikTok veya LinkedIn'de yayımlar; her adımı bir durum olarak ve post.published ile post.failed olayları aracılığıyla bildirir.
Gönderi API'sinin Instagram, Facebook, TikTok ve LinkedIn için ne kadar ileriye zamanlayabildiği; en erken süre 1 dakika sonradır.
easyCoexistence'ın gönderi planlandığında kopyaladığı en büyük resim ve en büyük video; daha büyük dosya o anda reddedilir.
Bir ağın hız sınırına takılan gönderi, başarısız işaretlenmeden önce yeniden denenir.
Bir Instagram hesabının kayan 24 saatlik süresinde API ile yayımlayabileceği gönderi sayısı; karusel tek sayılır.
TikTok'un yayımlama uç noktası üzerinden hesap başına video gönderilerine koyduğu sınır; bir dakikada en fazla altı.
Zamanlayıcının API'den neye ihtiyacı var?
Beş şey: dosya yükleyebileceği bir yer, bir gönderiyi tek bir hesap için kuyruğa alan bir çağrı, zamanında yayımlayan bir kuyruk, fikrini değiştirmenin bir yolu ve neler olduğuna dair bir bildirim. Gönderi API'si bu beşinin her birini, müşterilerinizi bağlayan aynı ec_live_ anahtarıyla sunar; böylece takvim, onay akışı ve düzenleyiciniz ürününüzde kalır.
Bir gönderi nasıl zamanlanır?
Hesap başına bir POST isteğiyle https://easycoexistence.com/api/v1/channels/:id/posts adresine gönderilir; burada :id, müşterinin bağlantı oturumundaki channel_id değeridir. publish_at, Z veya ofset içeren ISO 8601 biçimindedir; şimdi yayımlamak için bırakın. Yanıt, gönderiyle birlikte 201 olur; şimdi yayımlanması amaçlanan bir gönderi başarısız olursa 422 döner. Idempotency-Key başlığı desteklenir, bu yüzden zaman aşımından sonra tekrarlanan bir istek gönderiyi iki kez kuyruğa almaz. İstek gövdesi şunları alır:
- text: açıklama, mesaj veya yorum metni; media: {url, type} ya da {
media_id} listesi. - link: bir Facebook link gönderisi veya LinkedIn makalesi; LinkedIn'de başlıkla birlikte.
ig_type: IMAGE, CAROUSEL, REELS veya STORIES; atlanırsa medyadan çıkarılır.- title ve
disable_comment, TikTok fotoğraf gönderileri için;image_altise LinkedIn görseli için.
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"
}'Zamanlayıcı medyayı nasıl ele alır?
Bağlantıyla ya da yükleyerek. Herkese açık bir HTTPS bağlantısı doğrudan media alanına girer; kullanıcılarınızın yüklediği bir dosya ise POST /media uç noktasına, Content-Type ve Content-Length ile birlikte istek gövdesi olarak ya da {"url"} olarak gider ve döndürdüğü media_id gönderiye eklenir. Gönderi planlandığında easyCoexistence dosyalarını kopyalar; bu yüzden bağlantınızın yalnızca o an çalışması gerekir. Dosya yerine bir web sayfası, 404, yanlış tür ya da görseller için 30 MB'ı veya videolar için 1 GB'ı aşan bir dosya, gönderinin yayımlandığı sabah değil, o anda reddedilir.
Her ağın gönderisi neler taşıyabilir?
Kuyruk, her gönderiyi kabul etmeden önce ağın kurallarına göre denetler; bir kuralı çiğneyen gönderi, kuralı adlandıran bir mesajla reddedilir. Böylece düzenleyiciniz kullanıcı hâlâ düzenlerken sorunu gösterebilir. Her ağ şunları kabul eder:
Bir gönderi hangi durumlardan geçer?
Altı durum; GET /posts/:id ve GET /posts bunları publish_at, yayımlandığında gönderinin linki ve ağın hatasıyla birlikte bildirir:
- scheduled: kuyrukta, zamanını bekliyor.
- publishing: ağa teslim edildi.
- processing: ağ hâlâ üzerinde çalışıyor; bir TikTok videosu ya da Instagram konteyneri gibi.
- published: canlı, linkiyle birlikte.
- failed: reddedildi ya da onaylanmadı;
may_be_published, ağın almış olabileceği gönderileri işaretler. - canceled: yayından önce kaldırıldı; siz tarafından ya da kanalı kaldırıldığı veya askıya alındığı için.
Bir gönderi nasıl düzenlenir, iptal edilir veya yeniden denenir?
PATCH /posts/:id, zamanlanmış bir gönderinin zamanını veya metnini ve bir TikTok fotoğraf gönderisinin başlığını değiştirir; medyasını değiştirmek için iptal edip yeni bir gönderi zamanlayın. DELETE /posts/:id onu iptal eder. POST /posts/:id/retry, başarısız bir gönderiyi hemen yeniden yayımlar. Ağın hız sınırına takılan bir gönderi, 5 dakika, 30 dakika ve 2 saat sonra kendiliğinden yeniden denenir; may_be_published işaretli bir gönderi ise yeniden denemeden önce hesaba bakılmasını gerektirir.
Zamanlayıcınız neler olduğunu nasıl duyar?
Olaylardan ve listeden. Profile, Developers altında ayarlanan durum olayları URL'si, X-EC-Signature ile imzalanan post.published ve post.failed olaylarını gönderi ve kanalıyla birlikte alır; böylece takviminiz her birini canlı olarak işaretleyebilir ya da uyarı verebilir. GET /posts takvim görünümleri için status, from, to ve limit alır; GET /channels/:id/posts ise tek bir hesabı listeler. Arka planda başarısız olan bir gönderi, hesabın sahibine de e-posta gönderir; her kanal için 3 saatte en fazla bir kez.
LinkedIn gönderileri bir zamanlayıcıya nasıl uyar?
Her birini bir kişi onaylayarak. LinkedIn'in API Koşulları, API'lerini gönderileri otomatikleştirmek için kullanmayı kısıtlar; bu yüzden bir zamanlayıcı her LinkedIn gönderisini, adı belli bir kişi onaylayana kadar ürününüzde taslak olarak tutar ve sonra publish_at ile gönderir. Tekrarlayan kurallar, akış ve toplu içe aktarmalar diğer ağları hedeflemeli; LinkedIn'i yalnızca birinin incelediği gönderilere bırakın.
Yaygın hatalar
- Ofsetsiz publish_at göndermek. Z ya da ofset içermeyen yerel saat reddedilir; bu yüzden kullanıcınızın seçtiği çıplak saat yerine 2026-11-20T09:00:00-05:00 gönderin.
- may_be_published işaretli bir gönderiyi hemen yeniden denemek. Ağ onu zaten gösteriyor olabilir; bu yüzden önce hesabı kontrol edin, yoksa gönderi iki kez yayımlanır.
- Zaman aşımına uğrayan bir POST'u Idempotency-Key olmadan tekrarlamak. Her gönderiye kendi anahtarını verin; böylece tekrarlanan istek ikinci bir kopyayı zamanlamak yerine zaten kuyrukta olan gönderiyi döndürür.
- Instagram için PNG dosyalarını link olarak vermek. Instagram'ın yayımlama API'si yalnızca JPEG kabul eder ve gönderi planlandığında reddedilir; bu yüzden görselleri yükleme adımınızda dönüştürün.
easyCoexistence, zamanlayıcınıza müşterilerinizin Instagram, Facebook, TikTok ve LinkedIn hesapları ile daha fazla kanal için tek bir kuyruk sunar; her ağın resmi API'si üzerinden: gönderi planlandığında kopyalanan medya, altı durum, hız sınırları için yeniden denemeler, imzalı gönderi olayları ve her bağlantının 7/24 izlenmesi. Bağlantı başına ayda US$ 9 ile US$ 0,75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Tek bir istekle birden çok ağa gönderi zamanlanabilir mi?
Her istek tek bir kanalı hedefler; bu yüzden hesap başına birer tane gönderin, her birinin kendi Idempotency-Key değeriyle, ve metni her ağın sınırlarına uyarlayın.
Gönderi API'si YouTube videolarını zamanlar mı?
YouTube yerel olarak zamanlar. Videoyu YouTube API'si üzerinden publishAt ile private olarak yükleyin; GET /channels/:id?credentials=1 adresinden gelen token'ı kullanarak, YouTube videoyu o zamanda herkese açık yapar.
Kullanıcılarınız easyCoexistence panelinde zamanlanmış gönderilerini görebilir mi?
Gönderiler ekranı hesabınıza aittir; ekibiniz orada Needs attention, Coming up ve Published bölümlerini, Cancel, Retry ve Dismiss eylemleriyle görür. Kullanıcılarınız ise ürününüzün GET /posts'tan oluşturduğu takvimi görür.
easyCoexistence bir sosyal medya zamanlayıcısı için ne kadara mal olur?
Bağlı hesap başına ayda US$ 9 ile US$ 0,75 arasında, kullanıcılarınız daha fazla hesap bağladıkça düşer; zamanlama dahildir ve ilk 3 gün ücretsizdir.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi