Toplu fotoğraf yükleme durumunu kontrol edin

Asenkron bir toplu fotoğraf yüklemesinin durumunu düzenli aralıklarla sorgular. Bir toplu yükleme yeterince büyük olduğunda, konum fotoğrafları ekleme işlemi arka planda yürütür ve tamamlanmış medya yerine request nesnesinde bir requestId döndürür. Bunu tetikleyen toplu yükleme boyutu, yayımlanmış bir sabit yerine sunucu tarafında yapılandırıldığı için hangi işlem yolunun izlendiğini kendi görsellerinizi sayarak değil, request.requestId döndürülüp döndürülmediğini kontrol ederek belirleyin. İş sonuçlanana kadar bu endpoint'i söz konusu requestId ile düzenli aralıklarla sorgulayın.

Kullanım senaryosu: yükleme ilerleme çubuğunu güncelleme. Büyük bir toplu yüklemeden sonra, status değeri PROCESSING olduğu sürece birkaç saniyede bir sorgulama yapın. Değer SUCCESS veya ERROR olarak değiştiğinde, görsel başına sonucu öğrenmek için photos dizisini okuyun: her öğe, elde edilen mediaId değerini (başarılı olduğunda) ve bir status/errorMessage çiftini içerir; böylece tüm toplu yüklemeyi başarısız saymak yerine tam olarak hangi dosyaların neden reddedildiğini (yanlış boyutlar, desteklenmeyen biçim vb.) gösterebilirsiniz.

Durum değerleri: PROCESSING (işlem sürüyor: yeniden sorgulayın), SUCCESS (işin işlenmesi tamamlandı), ERROR (işin kendisi başarısız oldu; photos[].errorMessage değerini inceleyin).

İşin status değeri yalnızca işlemenin tamamlandığını bildirir; her görselin başarıyla işlendiğini değil. SUCCESS durumundaki bir iş, yukarıdaki örnekte olduğu gibi yine de reddedilen fotoğraflar içerebilir. İş PROCESSING durumundan çıktığında, hangi görsellerin başarıyla yüklendiğini öğrenmek için photos[] öğelerini tek tek gezin ve her öğenin kendi status ve errorMessage değerlerini okuyun.

Düzenli sorgulamada dikkat edilmesi gereken nokta: sorgulamalar arasında bekleyin: bu endpoint'e beklemeden art arda istek gönderen bir döngü, kısa sürede 429 ile karşılaşmanıza neden olur. Retry-After başlığını dikkate alın ve birkaç saniyelik bir aralığı tercih edin. Bilinmeyen veya süresi dolmuş bir requestId için sonuç alınamayacağından yalnızca yakın zamanda yapılan bir yükleme çağrısının döndürdüğü kimlikleri sorgulayın.