Webforumu Blog

Uygulamalı anlatım

API 429 döndürdüğünde istemci ne yapmalı?

İstek sınırına takılan istemcinin aynı anda daha fazla deneme yapmasını önleyip bekleme, üst sınır ve kullanıcı bildirimi tasarlayın.

Webforumu.net Editör Masası · Yayın: · Güncelleme:

Bir servis istek sınırına ulaştığınızı bildirdiğinde her hatada hemen yeniden istek göndermek durumu kötüleştirebilir. Önce hangi işin kaç istek ürettiğini ve eşzamanlı çalışan kopyaların olup olmadığını belirleyin. Aynı görevin birden fazla zamanlayıcı tarafından başlatılması kolay gözden kaçar.

Yanıtın anlamını okuyun

429 Too Many Requests, belirli zaman aralığında fazla istek gönderildiğini belirtir. Yanıtta Retry-After başlığı bulunabilir ve bekleme hakkında bilgi verebilir. Her servisin sınırları ve uygulama ayrıntıları aynı değildir; sağlayıcının ilgili API belgesini de inceleyin.

İstemciye sınırsız tekrar döngüsü koymayın. Azami deneme sayısı, bekleme ve işlem durumu açık tanımlanmalıdır. Her hata için bütün işi baştan başlatmak, daha önce tamamlanmış adımları gereksiz yere tekrar edebilir.

Kullanıcıya doğru durum gösterin

İşlemin başarısız mı olduğu, beklediği mi yoksa kısmen tamamlandığı mı anlaşılmalıdır. Örneğin rapor henüz alınamadıysa ekranda eski başarılı raporun tarihini koruyun. Yeni veri çekilememesini sıfır trafik sonucu gibi göstermeyin.

Deneme senaryosu

Test yanıtı olarak birkaç kez 429, ardından başarılı sonuç üretin. Uygulamanın beklediğini, deneme sınırını aştığında durduğunu ve aynı görevin ikinci kopyasını gereksiz yere açmadığını gözlemleyin. Bu denemeyi gerçek servisi aşırı yükleyerek yapmayın.

Sınırın kaynağını bulun

Kayıtta istek türü, zaman aralığı ve deneme sayısı bulunsun. Gizli API anahtarlarını veya yetkilendirme başlığını yazmayın. Kısa vadede bekleme mekanizması gerekse de kalıcı çözüm gereksiz istekleri azaltmak, uygun önbellek kullanmak veya iş planını düzenlemek olabilir. Önce tüketimi ölçün, sonra sınır değişikliği talep edin.