Rate limit ve hata kodları

İstek limiti (rate limit) API'yi aşırı yüklenmeye ve kötüye kullanıma karşı korur. Kısa süre içinde çok fazla istek gönderirseniz, sunucu HTTP 429 Too Many Requests yanıtını Retry-After başlığıyla birlikte döndürür; bu başlık kaç saniye beklemeniz gerektiğini belirtir.

Geçerli limitler

• Limit, her token için dakikada 60 istek. Tüm planlar için aynı şekilde geçerlidir (Trial, Standart, Profi ve Business).
• LAN ajanları için ayrı bir limit vardır: her ajan için dakikada 120 istek.
• Limit her token için ayrı hesaplanır (kullanıcının tamamı için değil). Daha yüksek bir toplam tavana ihtiyacınız varsa, farklı kullanımlar için birden çok token oluşturun (örneğin CI/CD için ayrı ve dashboard için ayrı).

Hata kodları

• 401 Unauthorized - eksik veya geçersiz token.
• 403 Forbidden - işlem planınızda kullanılamıyor (örneğin plan süresi dolduktan sonra veya plan limitinizin üzerinde monitör oluşturma).
• 404 Not Found - ilgili kaynak (monitor, olay) yok veya erişiminiz yok.
• 429 Too Many Requests - istek limiti aşıldı. Retry-After başlığında belirtilen saniye kadar bekleyin.
• 5xx - sunucu tarafı hatası. Kademeli olarak uzayan bir gecikmeyle tekrar deneyin (exponential backoff - örneğin 1, 2, 4, 8 saniye).

Pratik öneriler

• Okuma endpointlerinin yanıtlarını ön belleğe (cache) alın. Erişilebilirlik verileri her saniye değişmez, bu yüzden bu kadar sık çekmenize gerek yoktur.
• Mümkün olan yerlerde tekrar eden sorgulama (polling) yerine webhook kullanın - olay gerçekleştiğinde sunucu kendisi sizi arar.
• Toplu işlemlerde, limite yaklaşmamak için istekler arasına kısa bir gecikme koyun.