İstek hız sınırlarını ve sunucu hatalarını yönetin
429 yanıtlarından sonra bekleyin ve geçici sunucu hatalarından sonra güvenli işlemleri dikkatle yeniden deneyin.
Güncelleme:
429 yanıtını yönetin
Hız sınırına takılan bir istek, detail.status değeri rate_limit_exceeded olarak ayarlanmış 429 Too Many Requests yanıtını döndürür. Yeniden denemeden önce yanıt başlıklarını okuyun:
Retry-After, reddedilen istek için saniye cinsinden en kısa bekleme süresini verir.X-RateLimit-Limit, kova sınırını bildirir.X-RateLimit-Remaining, kalan istek sayısını bildirir.X-RateLimit-Reset, kovanın ne zaman sıfırlanacağını bildirir.
Retry-After süresi kadar bekleyin ve ardından üstel geri çekilme ile rastgele gecikme kullanarak yeniden deneyin. Paralel istekleri azaltın ve pencere sıfırlanır sıfırlanmaz yoğun istek göndermek yerine işleri sıraya alın.
Sunucu hatalarını yönetin
500 yanıtında genel bir hata ve request_id bulunur; iç istisna ayrıntıları döndürülmez. 503, gerekli bir hizmetin geçici olarak kullanılamadığını gösterebilir.
Salt okunur istekleri sınırlı bir geri çekilme süresiyle yeniden deneyin. Oluşturma, güncelleme, ödeme veya durumu değiştiren başka bir isteği yeniden denemeden önce ilk denemenin tamamlanıp tamamlanmadığını belirleyin. Zaman aşımı veya 5xx yanıtı, değişikliğin başarısız olduğunu kanıtlamaz; hemen tekrarlamak işi çoğaltabilir.
Tanılama bilgilerini saklayın
Zaman damgasını, yöntemi, yolu, durumu, yanıt gövdesini ve X-Request-Id değerini kaydedin. x-api-key değerini asla günlüğe yazmayın. Az sayıda ve sınırlandırılmış denemeden sonra otomatik yeniden denemeleri durdurup hatayı incelenmek üzere gösterin.