Adil kullanım ve API 'nin optimal performansını sağlamak için belirli kısıtlamalar uygulanmaktadır. Bu sınırların aşılması, erişimin geçici olarak askıya alınmasına neden olabilir, bu nedenle kullanımınızı dikkatlice anlamak ve izlemek önemlidir.
İstek Limitleri
- API anahtarı başına saatlik maksimum izin verilen istek sayısı 10.000'dir.
- Bu sınırı aşarsanız, API anahtarınız 24 saate kadar geçici olarak askıya alınabilir. Bu, API'nin tüm kullanıcılar için kararlı ve kullanılabilir kalmasını sağlamak için alınan koruyucu bir önlemdir.
Sınırı aşmamak için aşağıdaki en iyi uygulamaları göz önünde bulundurun:
- İstek Kullanımınızı İzleyin - İzin verilen eşik içinde kalmak için yaptığınız istek sayısını takip edin.
- İsteklerinizi Optimize Edin - Mümkün olduğunda veri alımlarını birleştirerek istek sayısını azaltın. API tarafından destekleniyorsa toplu işleme (batch processing) kullanın.
- Hız Sınırlandırması Uygulayın - Uygulamanızda hızlı ardışık isteklerle API'nin aşırı yüklenmesini önlemek için gecikme veya kuyruklama mekanizması entegre edin.
- Hız Sınırı Hatalarını Nazikçe Yönetin - İstek sınırınız aşıldığında, API uygun bir hata kodu dönecektir (örneğin, HTTP 429 - Çok Fazla İstek). Uygulamanızın bu hataları yönetebilmesini ve askıya alma süresi sonrası istekleri duraklatıp yeniden deneyebilmesini sağlayın.
HTTPS Üzerinden Güvenli İstekler
Tüm API istekleri, güvenlik ve veri bütünlüğünü sağlamak için HTTPS üzerinden yapılmalıdır. Düz HTTP üzerinden yapılan istekler otomatik olarak başarısız olacaktır. HTTPS, uygulamanız ile API sunucusu arasındaki iletişimi şifreler, API anahtarınız ve iletilen veriler gibi hassas bilgileri korur.
Kimlik Doğrulama Zorunludur
- Kimlik doğrulaması olmadan yapılan API istekleri başarısız olur.
- İstek başlıklarında API anahtarınızı veya erişim tokeninizi API dokümantasyonunda belirtildiği şekilde eklemelisiniz.
- Doğru kimlik doğrulama, isteklerinizin yetkilendirildiğini ve kullanım izleme ile hız sınırlandırması için takip edilebileceğini garanti eder.
Önemli Noktalar
- 24 saatlik askıya alma durumundan kaçınmak için saatlik 10.000 istek sınırı içinde kalın.
- Tüm isteklerde HTTPS kullanın; HTTP desteklenmez ve başarısız olur.
- Her isteğin, benzersiz API kimlik bilgileriniz kullanılarak doğru şekilde kimlik doğrulandığından emin olun.
Bu yönergelere uyarak ve en iyi uygulamaları hayata geçirerek, API'ye kesintisiz erişimi sürdürebilir, kesintilerden kaçınabilir ve güvenli ile verimli kullanım sağlayabilirsiniz.