Hız sınırları ve adil kullanım

Rakamlar

İstekler anahtar başına sayılır. Bir isteğin başlattığı iş, yani yeni kayıtlar ve dışa aktarmalar ise ayrıca hesap başına da sayılır: ikinci bir anahtar size ikinci bir istek bütçesi verir, ikinci bir kayıt hakkı vermez. Aşağıdaki her rakam çalışan yapılandırmadan okunur; bu sayfa API’nin gerçekte kullanmadığı bir rakamı gösteremez.

GET /me, son ikisini sizin hesabınız için, bugünün payından ne kadarının harcandığıyla birlikte bildirir. Yukarıdaki rakamların size de uyduğunu varsaymak yerine onu okuyun.

Başlıklar

Her yanıt, bu isteğin tükenmeye en yakın olduğu pencereyi anlatır: çoğu istek için dakikalık pencereyi, bir kayıt oluşturma ya da dışa aktarma için de o işin kendi bütçelerinden hangisi daha darsa onu. Yalnızca reddettiğimiz yanıtlar değil, hepsi; bunlara bakarak hızını ayarlayan bir istemci nadiren 429 alır.

RateLimit-Limit: 120
RateLimit-Remaining: 114
RateLimit-Reset: 41
X-Request-Id: 0f2f5f6a-2c6c-4f4e-9d1e-5d8f2a1b3c4d

• RateLimit-Remaining — anlattığı pencerede kalan miktar.
• RateLimit-Reset — o pencerenin yeniden dolmasına kalan saniye.
• Retry-After — yalnızca 429 ile gelir. Tam olarak o kadar bekleyin.

Adil kullanım

İstek hızının ötesinde, bir hesabın bir günde deşifre ettiği ses miktarının ve tek bir kaydın uzunluğunun da bir tavanı var. Yoğun bir entegrasyonun asıl takıldığı sınır budur: istekleri değil, işi sınırlar.

Günlük pay, kayıt oluşturulurken kontrol edilmez; bir kaydın ne kadar uzun olduğu indirilene kadar bilinmez. Payı aşan bir kayıt kabul edilir, sonra failure_reason: "quota_exceeded" ile başarısız olur. Pay her gün yenilenir; hemen değil, yenilendiğinde yeniden gönderin.

Eşzamanlılık

Her plan aynı anda belirli sayıda kaydın işlenmesine izin verir. Bir fazlasını oluşturursanız istek 409 concurrency_limit döner, 429 değil; çünkü bir hız penceresini beklemek burada işe yaramaz. Bir kaydın bitmesini bekleyip yeniden deneyin: reddedilen bir kayıt oluşturma isteği saatlik ya da günlük bütçeden düşmez. Son boş yer için yarışan bir işçi filosu da doğru ele alınır: yalnızca biri kazanır.

429 aldığınızda

1. Retry-After başlığını okuyun ve o kadar saniye bekleyin. Daha erken denemeyin; erken bir deneme bir istek daha harcar ve hiçbir şeyi doldurmaz.
2. Bir kayıt oluşturma isteğiyse aynı Idempotency-Key ile yeniden deneyin; bkz. Idempotency.
3. Çok sayıda kaydın durumunu sorguluyorsanız kuyruğu değil aralığı uzatın; bkz. durum sorgulama.

Bir sınırı yükseltmek

Bunlar varsayılan değerler, aşılmaz bir duvar değil. Entegrasyonunuz gerçekten daha fazlasına ihtiyaç duyuyorsa (bir arşivin taşınması, ay sonundaki bir yoğunluk gibi) yükün nasıl bir şey olduğunu bize yazın; sınırları herkes için değil, sizin hesabınız için yükseltelim.