Toplu API

Toplu API (bulk API), bir sağlayıcının çok sayıda kaydı bir kerede taşımak için sunduğu, sıradan uygulama trafiğine hizmet eden kayıt başına API'den ayrı bir uç nokta kümesidir. Var olma nedeni, bu iki iş yükünün ortak hiçbir yanı olmamasıdır: biri tek bir kaydı milisaniyeler içinde geri ister, diğeri yüz bin kaydın taşınmasını ister ve bunun saat içinde tam olarak ne zaman biteceğini umursamaz. İkincisini birincisi üzerinde hızlı bir döngü olarak ele almak, entegrasyonların ilk geriye doldurmaları sırasında hız sınırına takılıp durma biçimidir. Üç fark diğerlerinden daha önemlidir. Toplu API genellikle eşzamansızdır — bir iş gönderirsiniz, bir tanımlayıcı alırsınız, durumunu yoklarsınız ve bir yanıt okumak yerine sonucu indirirsiniz; bu da kodunuzun, onu oluşturan istekten daha uzun yaşayan bir işi tutacak bir yere ihtiyacı olduğu anlamına gelir. Farklı ölçülür; genellikle istek başına sınıra değil, iş ya da satır tahsisine karşı sayılır, dolayısıyla sıradan API için kurduğunuz bütçe burada yanlış bütçedir. Ve hatalar kayıt başına döner: bir iş, satırlarının bir bölümü doğrulamada reddedilmişken başarı bildirebilir; bu da toplu bir içe aktarmanın aylar sonra bir veri sorununa dönüşmesinin en yaygın yoludur. Yalnızca iş durumuna bakan bir çağıran, kısmi bir aktarmayı temiz bir aktarma olarak kaydetmiştir. Küçük farklar da insanları yakalar. Alan kapsamı çoğu zaman kayıt API'sinden dardır; normalde oluşturabildiğiniz bir nesne toplu olarak oluşturulamayabilir ya da her özelliğiyle oluşturulamayabilir. Doğrulama bazen daha gevşektir; yani toplu yol, etkileşimli API'nin reddedeceği kayıtların sisteme girdiği bir kapıdır. Bir iş içindeki sıra garanti edilmez; dolayısıyla aynı kayda ait hem bir oluşturma hem de sonraki bir güncelleme içeren bir yığının o sırayla uygulanacağını varsaymak güvenli değildir. Pratik alışkanlıklar: her zaman kayıt başına sonucu okuyun ve sayıları karşılaştırın, asla yalnızca iş durumunu değil; her işe bir idempotency anahtarı ya da istemci tarafı yığın tanımlayıcısı verin ki zaman aşımından sonraki yeniden gönderim her şeyi iki kez yazmasın; yığınları belleğe sığana göre değil sağlayıcının belirttiği en yüksek değere göre boyutlandırın; ve ilk gerçek yığını, reddedilenlerin bir insan tarafından okunabileceği kadar küçük tutun.