[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"glossary-bulk-api::tr":3,"gloss-cluster-bulk-api::tr":26,"gloss-next-bulk-api::tr":9},{"slug":4,"category":5,"name":6,"definition":7,"meta_desc":8,"faq":9,"schema_markup":9,"related":10},"bulk-api","integration","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.\n\nÜç 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.\n\nKüçü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.\n\nPratik 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.","Toplu API çok sayıda kaydı tek bir eşzamansız işte taşır: ayrı ölçülür ve satırların bir bölümü reddedilmişken başarı bildirebilir.",null,[11,14,17,20,23],{"slug":12,"name":13},"backfill","Geriye Dönük Doldurma (Backfill)",{"slug":15,"name":16},"concurrency-limit","Eşzamanlılık Sınırı",{"slug":18,"name":19},"cursor-pagination","İmleç Tabanlı Sayfalama (Cursor Pagination)",{"slug":21,"name":22},"idempotency-key","Idempotency Anahtarı (Tekrardan Bağımsızlık Anahtarı)",{"slug":24,"name":25},"rate-limit","Hız Sınırı (Rate Limit)",[27,31,34,38,39,42,45,48,51,54,57,60],{"slug":28,"category":5,"name":29,"updated_at":30},"api-deprecation","API Kullanımdan Kaldırma","2026-09-08T21:32:37+00:00",{"slug":32,"category":5,"name":33,"updated_at":30},"app-review","Uygulama İncelemesi",{"slug":35,"category":5,"name":36,"updated_at":37},"backend-for-frontend","Frontend için Arka Uç (BFF)","2026-09-08T21:32:36+00:00",{"slug":15,"category":5,"name":16,"updated_at":37},{"slug":40,"category":5,"name":41,"updated_at":30},"connector-versioning","Bağlayıcı Sürümleme",{"slug":43,"category":5,"name":44,"updated_at":30},"delete-propagation","Silme Yayılımı",{"slug":46,"category":5,"name":47,"updated_at":30},"effective-permissions","Etkin İzinler",{"slug":49,"category":5,"name":50,"updated_at":37},"event-ordering","Olay Sıralaması",{"slug":52,"category":5,"name":53,"updated_at":37},"field-mapping","Alan Eşleme (Field Mapping)",{"slug":55,"category":5,"name":56,"updated_at":37},"function-schema","Fonksiyon Şeması",{"slug":58,"category":5,"name":59,"updated_at":37},"grpc","gRPC",{"slug":61,"category":5,"name":62,"updated_at":37},"integration-marketplace","Entegrasyon Pazar Yeri (Integration Marketplace)"]