429 Too Many Requests yanıtı alırsınız.
Limitler
Genel API limiti Flextell’in tarafında yapılandırılabilir bir değerdir (varsayılan: 60/dk). Yüksek hacimli entegrasyonlarınız için limit yükseltilmesini istemek üzere destek ekibiyle iletişime geçebilirsiniz. Hassas ve 2FA limitleri güvenlik nedeniyle sabittir.
Kim sınırlanır?
Rate limit, authentice olmuş kullanıcının ID’si üzerinden uygulanır —client_id üzerinden değil. Yani aynı kullanıcı birden fazla uygulamaya yetki verirse, kullanıcının toplam istekleri sınırlanır, her uygulama ayrı kota almaz.
Henüz oturum açmamış isteklerde (ör. OAuth token değişimi) limit IP başına uygulanır.
429 yanıtı
Doğru yeniden deneme (retry) örüntüsü
429 aldığınızda:Retry-Afterheader’ını okuyun.- O kadar saniye bekleyin.
- Aynı isteği tekrar deneyin.
Retry-After yoksa exponential backoff kullanın: 1s, 2s, 4s, 8s... en fazla birkaç deneme.
Limiti zorlamamak için
- Batch okuyun. 50 hastayı
GET /customersile bir kerede çekin, 50 ayrıGET /customers/{id}atmaktan vazgeçin. - Cache’leyin. Nadiren değişen veriler (doktorlar, tedaviler, tenant listesi) için saatlerce cache makul.
- Webhook / realtime kullanın. Yeni mesaj veya randevu değişikliği için polling yerine Realtime kanallarını dinleyin.
- Paralelliği sınırlayın. Bir seferde en fazla 5–10 eşzamanlı istek yeterli olacaktır.
İpucu: kendi rate-limit monitoringiniz
Her yanıttaX-RateLimit-Remaining değerini loglayıp düşüşleri izleyin. Eşik (ör. < 10) altına düşerse ilgili entegrasyonu geçici olarak yavaşlatın.