Editör Genel Bakış
Editör her gönderi için giriş noktasıdır. /app/publishing (Zamanlamalar sekmesi), pano hızlı eylemi veya herhangi bir kampanya/etiket detay sayfasından açılır. Tek bir gönderme bir veya birden fazla kanalı hedefler ve backend yayın anında dağıtım yapar.
İstek şekli
Editörü göndermek POST /api/v1/posts çağırır. Doğrulanan body alanları:
accounts— kanal ID'leri dizisi (min 1).caption— string, min 1 karakter.link— açıklamaya eklenen opsiyonel URL.media— Dosya Kütüphanesi varlık ID'leri dizisi (opsiyonel).type—"text"veya"media".labels— etiket ID'leri dizisi (opsiyonel).campaign— opsiyonel kampanya ID'si.post_by— 0–3 arası tam sayı (teslim modu, aşağıya bak).time_posts—post_by !== 0olduğunda ISO-8601 zaman damgaları dizisi (kanal başına bir).variations—caption,media,linkiçin opsiyonel kanal-başı override dizisi.
Endpoint kimlik doğrulama, bağlı bir çalışma alanı, aktif bir abonelik gerektirir ve saklamadan önce bir kota kontrolünü geçer.
Teslim modları (post_by)
| Değer | Anlam |
|---|---|
0 | Anında yayınla — time_posts görmezden gelinir. |
1 | Repost ile zamanla (tekrarlama desteği — bkz. Zamanlama). |
2 | Belirli günler ve saatler — time_posts içinde birden fazla slot. |
3 | Taslak olarak kaydet. |
Zamanlanmış zaman damgaları gelecekte en az 1 dakika olmalıdır; API, geçmişe tarihli zamanlamaları 400 ile reddeder.
Yaşam döngüsü durumları (status)
| Değer | Durum |
|---|---|
0 | Taslak |
1 | Bekleyen (kuyrukta) |
2 | Yayınlanıyor |
3 | Yayınlandı |
4 | Başarısız |
failed durumundaki bir gönderi platformun hata mesajını inline gösterir; aynı editörden düzenleyip tekrar deneyebilirsin.
Çoklu kanal dağıtımı
Bir POST /api/v1/posts isteği birçok kanalı hedefleyebilir. Backend her kanalı yayın anında bir dağıtım bacağı olarak işler — bir kanalın başarısızlığı diğerini etkilemez. Platformlar farklı conventions'a sahipse (örn. X'te daha kısa metin, Instagram'da hashtag'ler) variations dizisini kullanarak caption / media / link'i kanal bazında override et.
Onay akışı
Gönderilerin bir approval_status alanı vardır (draft, pending_review, approved, rejected). İncelemeye gönder eylemine sahip editörler POST /api/v1/posts/:id/submit-review çağırarak bir taslağı pending_review'e gönderir. Adminler aynı sayfadan onaylar; reddedilen gönderiler reviewer yorumlarıyla birlikte taslaklara geri döner.