Toplu gönderi işini alın

POST /social/bulk-posts ile oluşturulan bir iş hakkında bilgi verir. status nihai bir değere ulaşana kadar işi düzenli aralıklarla sorgulayın, ardından her satırın nasıl sonuçlandığını öğrenmek için results[] alanını okuyun.

Kullanım senaryosu: toplu yükleme sonuçlarını kendi takviminizle eşleştirme. Bir toplu işlem gönderdikten sonra bu uç noktayı birkaç saniyede bir sorgulayın. status nihai bir değere ulaştığında results[] içindeki öğeleri tek tek inceleyin ve her öğenin clientReference değerini kendi kaydınızla eşleştirerek socialPostId değerini bu kayda yazın. status: "FAILED" durumundaki satırlar, nedeni errors[] alanında taşır; yeni bir toplu işlemde yalnızca bu satırları yeniden gönderin.

Kullanım senaryosu: ilerleme çubuğu. processedCount değerinin totalCount değerine oranı, results[] içindeki öğeleri hiç incelemeden bir ilerleme çubuğu oluşturmak için yeterlidir ve successCount / failureCount, iş sonuçlandığı anda size genel sonucu verir.

İş durumları

Notlar.

• clientReference, o satırda gönderdiğiniz değerin aynen geri döndürülen hâlidir. Kendi verilerinizle bağlantı kurmanın en doğrudan yoludur; bu değeri göndermediğinizde, satırın gönderdiğiniz dizideki 0 tabanlı konumu olan index alternatif olarak kullanılır.
• Bir satırın status: "CREATED" durumuna ulaşması, gönderinin var olduğu anlamına gelir, yayımlandığı anlamına gelmez — postStatus, gönderinin kendisinin hangi aşamada olduğunu belirtir. PUBLISH ve SCHEDULE durumundaki satırlar daha sonra yine asenkron yayımlama sürecinden geçer: her socialPostId değerini GET /social/posts/{postId} ile kullanın ve kanal bazındaki gerçek sonucu öğrenmek için channels[] alanını okuyun.
• Tüm satırları doğrulamada başarısız olan bir iş hiç oluşturulmazdı, çünkü toplu oluşturma, toplu işlemi kuyruğa almadan önce reddeder. Burada FAILED durumundaki bir iş, işin kabul edildikten sonra başarısız olduğu anlamına gelir.
• updatedAt, satırlar işlendikçe değişir; iş nihai bir duruma ulaştığında sabitlenir.