Hız sınırları

Sınır	Neye göre sayılır	Pencere
/api/integrations/v1 üzerinde 60 çağrı (Exchange) ya da 300 çağrı (Enterprise)	Anahtar	1 dakika, sabit
/oauth/token üzerinde 20 belirteç isteği	Çağıran IP adresi	1 dakika, sabit
POST /deals/{id}/documents üzerinde 50 belge ve 250 MB (Exchange) ya da 200 belge ve 1 GiB (Enterprise)	Şirket (canlı ve deneme ayrı)	UTC günü
Yazma çağrılarında 5.000 yeni idempotency anahtarı	Anahtar	UTC günü

• Sayıları planınız belirler. Bunlar varsayılan değerlerdir. Hız sınırı ve yükleme hakkı her çağrıda şirketinizin planına göre uygulanır; plan değişikliği bir sonraki çağrıdan itibaren geçerlidir. Bkz. Erişim.
• Şirket değil, anahtar başına. Her anahtarın kendi bütçesi vardır; uygulamayı kullanan bir kişi onu hiçbir zaman paylaşmaz. Bir anahtar için verilen belirteç o anahtarın bütçesinden sayılır.
• Tüm sunucular tek pencereyi paylaşır; sınır, API’nin arkasındaki sunucu sayısıyla büyümez.
• Sabit pencereler. Sayaç her bir dakikalık pencerenin başında sıfırlanır; kayan bir sayım değildir.

Sınıra ulaştığınızda

Yanıt 429 Too Many Requests olur. Retry-After başlığı varsa o kadar saniye, yoksa birkaç saniye bekleyin. Gövdeye güvenmeyin: boş olabilir.

İyi bir istemci:

1. Çağrılarını yığın hâlinde değil, yayarak gönderir.
2. 429 aldığında Retry-After kadar (ya da birkaç saniye) bekler, sonra artan aralıklarla (örneğin 2, 4, 8 saniye) tekrar dener.
3. Oluşturmayı aynı X-Idempotency-Key ile tekrarlar; böylece çalışmış bir oluşturma asla tekrarlanmaz. Bkz. Idempotency.

Daha az çağrıyla çalışmak

• Sormak yerine dinleyin. Webhook’lar talep yayınlandığında, teklif geldiğinde, anlaşma başladığında, kilometre taşı kaydedildiğinde ve başka olaylarda haber verir. Ayrıntıyı olay geldiğinde okuyun. Bkz. Webhook’lar.
• OAuth kullanıyorsanız belirteci her çağrıda değil, 15 dakikada bir alın.

Hız sınırına takılan çağrılar çağrı kaydında listelenmez.

Günlük yükleme hakkı

Belge yüklemeleri ayrıca şirket başına günlük bir hakka sayılır: varsayılan olarak UTC günü başına Exchange’de 50 dosya ve 250 MB, Enterprise’da 200 dosya ve 1 GiB; canlı ve deneme alanı ayrı. Aşılınca yükleme 429, Integration.DailyUploadLimit ve UTC gece yarısına kadar süren bir Retry-After ile döner. Bir kural yüzünden reddedilen yükleme sayılmaz; virüslü bulunan dosya sayılır. Bkz. Belge yükleme.

Günlük idempotency hakkı

Her anahtar, her planda, UTC günü başına yeni bir X-Idempotency-Key taşıyan 5.000 yazma çağrısı gönderebilir. Hak dolunca yazma çağrısı 429, Idempotency.DailyLimit ve UTC gece yarısına kadar süren bir Retry-After alır, hiçbir şey çalışmaz; böylece bir yazma, tekrar koruması olmadan asla yapılmaz. Yanıtlanmış bir anahtarın tekrarı sayılmaz. Bkz. Idempotency.