Zamanlanmış bir gönderiyi iptal etme

Henüz yayımlanmayı bekleyen bir gönderiyi iptal eder. Gönderi ARCHIVED durumuna geçer ve yayımlama süreci gönderiyi işleme almayı bırakır. Taslaklar da aynı şekilde iptal edilebilir; daha önce yayımlanmış gönderiler iptal edilemez.

Kullanım senaryosu: bir müşteri son anda bir kampanyadan vazgeçer. Takviminizde zamanlanmış bir gönderi görünür, müşteri fikrini değiştirir ve siz de gönderiyi kendi kullanıcı arayüzünüzden iptal edersiniz. Gönderinin id değerini doğrudan markanın gönderi listesinden alın ve bu endpoint'i çağırın; satır ARCHIVED durumuna geçer ve bir sonraki okuma işleminde {"status":["SCHEDULED"]} filtresinin sonuçlarından çıkar.

Kullanım senaryosu: bir kanalın bağlantısını kesmeden önce temizlik yapma. Bir bağlantının kesilmesi, o bağlantı için zaten sıraya alınmış gönderileri iptal etmez; bunun yerine gönderiler yayımlama sırasında SY95045 hatasıyla başarısız olur. Önce zamanlanmış gönderileri iptal edin, ardından bağlantıyı kesin; böylece müşteri hiçbir başarısızlık görmez.

Notlar.

• İstek gövdesi bir input nesnesi içine alınmalıdır.
• HTTP durumunu değil, success değerini kontrol edin. Daha önce yayımlanmış veya iptal edilmiş bir gönderi için success: false ile birlikte HTTP 200 döndürülür.
• Bu bir silme işlemi değildir. Hiçbir platformdan hiçbir şey kaldırılmaz. Daha önce yayımlanmış bir gönderi yayında kalır ve bu çağrı, söz konusu gönderi için yalnızca success: false bildirir. Bir sosyal medya gönderisini yayından kaldıran bir endpoint yoktur; kaldırma işlemi platformun kendisinde yapılır.
• İptal işlemi, gönderinin tüm kanallarına uygulanır veya hiçbirine uygulanmaz. Zamanlanmış bir gönderiyi bir platformda iptal ederken başka bir platformda yayımlanmasına izin vermenin bir yolu yoktur; buna ihtiyacınız varsa ayrı gönderiler oluşturun.
• Gönderi, işlemden sonra da post.status değeri ARCHIVED olacak şekilde GET /social/posts/{postId} ile okunabilir.

Yazma işlemi: canlı hesap üzerinde yürütülmemiştir. Gösterilen istek ve yanıt, API şemasından oluşturulmuştur.