API Kullanım Limitleri (Rate Limit)

Sistem güvenliği ve sürdürülebilirliği sağlamak amacıyla müşteri bazlı rate limit kuralları uygulanmaktadır. Bu limitler, satın alınan kontör miktarına ve sözleşme koşullarına göre dinamik olarak belirlenmektedir.

Sağlıklı Entegrasyon İçin Öneriler:
  • ERP sistemlerinizde e-belge oluşturulduktan sonra belgelerin e-şirket sistemine asenkron olarak gönderilmesi önerilmektedir.
  • Belirli saatlerde çalışan zamanlanmış görevleriniz (Joblar) için, alınmış kontör miktarı ve sözleşme süresi dikkate alınarak aylık ve günlük ihtiyaçların dengeli şekilde planlanması, isteklerin 24 saate yayılması gerekmektedir.
Bu yaklaşımlar benimsendiği takdirde, sistemlerimizin güvenliği ve sürekliliği için uygulanan kurallara takılmadan sorunsuz bir entegrasyon sağlanabilir.
Önemli Uyarı:

Toplu ve yüksek frekanslı istek gönderilmesi durumunda, ilgili istekler otomatik olarak sistemlerimiz tarafından 429 (Too Many Requests) HTTP durum kodu ile engellenecektir. Test ortamındaki limitler, canlı ortam ile aynıdır.

Not:
  • Tablodaki değerler istek adedi / periyot dakika formatındadır.
  • Rate limit kotaları, satın almış olduğunuz pakete göre ürün ve servis bazlı aşağıdaki gibidir.
e-Fatura endpoint bazlı rate limit değerleri
Kural Endpoint 1000 - 5000 Kontör 10.000 - 50.000 Kontör 75.000 - 250.000 Kontör 500.000 - 1.000.000 Kontör 2.000.000 - 5.000.000 Kontör 10.000.000 - 15.000.000 Kontör 20.000.000 - 30.000.000 Kontör 40.000.000 - 50.000.000 Kontör +50.000.000 Kontör
Statü Sorgulama GET /v2/outboxinvoice/*/status 100 / 180 dk 100 / 180 dk 300 / 180 dk 900 / 180 dk 4.400 / 180 dk 13.100 / 180 dk 26.100 / 180 dk 43.500 / 180 dk 86.900 / 180 dk
Statü Sorgulama GET /v2/inboxinvoice/*/status 100 / 180 dk 100 / 180 dk 300 / 180 dk 900 / 180 dk 4.400 / 180 dk 13.100 / 180 dk 26.100 / 180 dk 43.500 / 180 dk 86.900 / 180 dk
Statü Sorgulama GET /v2/earchive/status 100 / 180 dk 100 / 180 dk 300 / 180 dk 900 / 180 dk 4.400 / 180 dk 13.100 / 180 dk 26.100 / 180 dk 43.500 / 180 dk 86.900 / 180 dk
Statü Sorgulama GET /v2/earchive/*/status 100 / 180 dk 100 / 180 dk 300 / 180 dk 900 / 180 dk 4.400 / 180 dk 13.100 / 180 dk 26.100 / 180 dk 43.500 / 180 dk 86.900 / 180 dk
Statü Sorgulama POST /v2/outboxinvoice/status 100 / 180 dk 100 / 180 dk 300 / 180 dk 900 / 180 dk 4.400 / 180 dk 13.100 / 180 dk 26.100 / 180 dk 43.500 / 180 dk 86.900 / 180 dk
Gelen Fatura Listeleme GET /v1/inboxinvoice/list 6 / 15 dk 6 / 15 dk 6 / 15 dk 6 / 15 dk 6 / 15 dk 6 / 15 dk 6 / 15 dk 6 / 15 dk 6 / 15 dk
PDF Oluşturma POST /v2/outboxinvoice/*/pdf/* 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 30 / 1 dk 60 / 1 dk 60 / 1 dk
PDF Oluşturma GET /v2/outboxinvoice/*/pdf/* 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 30 / 1 dk 60 / 1 dk 60 / 1 dk
PDF Oluşturma POST /v2/inboxinvoice/*/pdf/* 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 30 / 1 dk 60 / 1 dk 60 / 1 dk
PDF Oluşturma GET /v2/inboxinvoice/*/pdf 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 30 / 1 dk 60 / 1 dk 60 / 1 dk
PDF Oluşturma GET /v2/earchive/*/pdf/* 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 30 / 1 dk 60 / 1 dk 60 / 1 dk
UBL Görüntüleme GET /v2/inboxinvoice/*/ubl 30 / 1 dk 30 / 1 dk 30 / 1 dk 45 / 1 dk 45 / 1 dk 45 / 1 dk 45 / 1 dk 75 / 1 dk 75 / 1 dk
UBL Görüntüleme GET /v2/earchive/*/ubl 30 / 1 dk 30 / 1 dk 30 / 1 dk 45 / 1 dk 45 / 1 dk 45 / 1 dk 45 / 1 dk 75 / 1 dk 75 / 1 dk
PDF Oluşturma GET /v2/inboxinvoice/*/pdf/* 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 30 / 1 dk 60 / 1 dk 60 / 1 dk
PDF Oluşturma GET /v2/outboxinvoice/*/pdf 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 15 / 1 dk 30 / 1 dk 60 / 1 dk 60 / 1 dk
e-İrsaliye rate limit tablosu yakında eklenecektir.
e-Defter rate limit tablosu yakında eklenecektir.
e-Bilet rate limit tablosu yakında eklenecektir.

Sorun yaşamanız durumunda entegrasyon@eplatform.com.tr adresi üzerinden destek alabilirsiniz.