API hız sınırları ve yeniden denemeler

API hız sınırları ve yeniden deneme kuralları, istemci ile API arasındaki sözleşmenin parçasıdır. İstemci başarılı yanıtı, doğrulama hatasını, kimlik doğrulama hatasını, hız sınırını ve geçici sunucu hatasını birbirinden ayırt edebilmelidir. JSON ya da XML kullanmak HTTP semantiğini değiştirmez; IPv4/IPv6 değerleri de IPv4 uzunluğu varsayılmadan eksiksiz saklanmalıdır.

Yanıtı işlemek

Content-Type'ı, durum kodunu, belgelenmiş alanları ve kotayı doğrulayın. HTTP 429'u ayrıca ele alın: Retry-After gönderilmişse ona uyun, jitter eklenmiş ve üst sınırı olan üstel geri çekilme (exponential backoff) kullanın. Yeniden denemeden önce işlemin idempotent olup olmadığını düşünün. İstek kimliklerini, durum kodunu ve gecikmeyi loglayın, fakat API anahtarlarını asla loglara yazmayın.

429 yanıtını doğru ele almak

API 429 döndürdüğünde körü körüne sabit bir süre beklemeyin; yanıtta Retry-After varsa onu okuyun. Yeniden deneme sayısına bir sınır koyun, üstel geri çekilmeye jitter ekleyin ve tekrarlandığında yan etkiyi ikiye katlayabilecek işlemleri otomatik olarak yeniden göndermeyin. Gerçek bir istek denemek ve güncel API sözleşmesini görmek için 2IP API'si sayfasına bakın.