Ana içeriğe atla
GetQR API’si beta aşamasındadır ve seçili çalışma alanlarında kullanılabilir. Ayrıntılar genel sürümden önce değişebilir.
GetQR API’si her API anahtarının gönderebileceği istek sayısını sınırlar; böylece tek bir entegrasyon API’yi herkes için yavaşlatamaz.

Sınırlar

Sınır, kayan bir dakikalık pencere üzerinden sayılır ve tüm uç noktalara birlikte uygulanır. Durum kontrolü anahtar gerektirmez ve sayılmaz.

Sınır başlıkları

Geçerli bir API anahtarıyla yapılan isteklerin yanıtları, hata yanıtları dahil, şu başlıkları içerir:

Sınırı aştığınızda

Sınır aşıldığında API, rate_limit_exceeded koduyla ve aynı başlıklarla 429 yanıtı verir:
Daha fazla istek göndermeden önce sıfırlanma zamanına kadar bekleyin. Birden fazla işçi aynı anda yeniden denemesin diye rastgele gecikme (jitter) ekleyin ve 5xx hatalarında üstel olarak geri çekilin:
POST /api/v1/qrs isteğini yalnızca bir Idempotency-Key başlığıyla yeniden deneyin. Böylece yeniden deneme hiçbir zaman ikinci bir QR kodu oluşturmaz. Bkz. Idempotency.

Sınırın altında kalın

  • X-RateLimit-Remaining değerini izleyin ve 0’a ulaşmadan önce yavaşlayın.
  • Her QR kodu için ayrı bir istek yerine toplu QR oluşturmayı kullanın.
  • pageSize=100 ile sayfa başına en fazla 100 sonuç alın. Bkz. Sayfalama.
  • QR görsellerini önbelleğe alın: indirmeler bir ETag döndürür; böylece If-None-Match gönderebilir ve hiçbir şey değişmediğinde 304 Not Modified alabilirsiniz.

Sırada ne var

Hatalar

QR kodları