Rate Limits#

Last updated: 18 OCT 2026

English · Türkçe

English#

Rate limits have been set with fair use for all users and the capacity of our servers in mind. In normal use you will not reach them; they only apply to excessive, sustained heavy use.

How limits are counted#

• Limits are counted per access token, not per IP address. Users sharing the same network (e.g. CG-NAT users sharing the same external IP address) do not use up each other's allowance.
• Every service has its own counter; heavy use of one service does not affect the others.
• Limits work like a bucket:
  • Bucket: the number of requests you can make without waiting.
  • Refill: how fast used allowance comes back.
  • When the bucket is empty, requests are either held for a moment or slowed down, depending on the service; the bucket refills by itself.

User types#

A token obtained with a personal API token always counts as Developer.

Limits per service#

AIS PIB API#

OPMET, NOTAM, meteorology and the other modules of the AIS PIB API.

The "is there an update" polls of the live traffic layers (VATSIM, IVAO) are counted separately: 240 per minute for visitors and users (bucket 20), 1,200 per minute for developers (bucket 100).

AIS Charts API#

AIS Jeppesen API#

Tile Server#

Base layers and overlays of the Tile Server. When the bucket is empty the map is slowed down, not cut off.

Geo Server#

Map queries and georeferenced charts (WMS/WFS) of the Geo Server. When the bucket is empty requests are slowed down, not cut off.

The service description request (GetCapabilities) has its own, stricter limit: 1 per minute for visitors and users (bucket 2–3), 5 per minute for developers (bucket 15). This information rarely changes; fetch it once and keep it.

ATC Broadcasts#

ATC Surveillance#

Data Link Backend#

Data Link API (D-ATIS and DCL)#

What happens at the limit#

• The server answers HTTP 429 (Too Many Requests) with a Retry-After header saying after how many seconds you may try again (usually 2 seconds; 60 seconds for the service description request).
• ibonav.aero and the Interactive Map handle this themselves: the request is retried automatically after a short wait.
• For tiles and Geo Server queries, requests are slowed down instead of refused.

Tips for developers#

• On a 429, wait the number of seconds in Retry-After before trying again; do not retry immediately and repeatedly.
• Reuse the 1-hour access token you get with your personal API token until it expires. Do not request a new token for every call; getting new tokens is limited per hour as well.
• Cache data that rarely changes (service descriptions, lists).
• Query data at intervals that match how often it is updated, instead of asking for the same data again and again.

Türkçe#

Hız sınırları, tüm kullanıcıların hizmetlerden adil biçimde yararlanabilmesi ve sunucu kapasitesinin korunması gözetilerek belirlenmiştir. Normal kullanımda bu sınırlara takılmazsınız; sınırlar yalnızca aşırı ve sürekli yoğun kullanımda devreye girer.

Sınırlar nasıl sayılır?#

• Sınırlar erişim anahtarınıza (token) göre sayılır, IP adresinize göre değil. Aynı ağı paylaşan kullanıcılar (ör. aynı dış IP adresini paylaşan CG-NAT kullanıcıları) birbirinin hakkını tüketmez.
• Her hizmetin kendi sayacı vardır; bir hizmetteki yoğun kullanım diğerlerini etkilemez.
• Sınırlar bir kova gibi çalışır:
  • Kova: beklemeden kullanabileceğiniz en çok istek sayısı.
  • Dolum: kullandığınız hakkın geri gelme hızı.
  • Kova boşaldığında, hizmete göre istekleriniz ya kısa bir süre bekletilir ya da yavaşlatılır; kova kendiliğinden yeniden dolar.

Kullanıcı türleri#

Kişisel API anahtarıyla alınan token her zaman Geliştirici sayılır.

Hizmet başına sınırlar#

AIS PIB API#

AIS PIB API'nin OPMET, NOTAM, meteoroloji ve diğer modülleri.

Canlı trafik katmanlarının (VATSIM, IVAO) "güncelleme var mı" yoklamaları ayrı sayılır: ziyaretçi ve kullanıcı için dakikada 240 (kova 20), geliştirici için dakikada 1.200 (kova 100).

AIS Charts API#

AIS Jeppesen API#

Tile Server#

Tile Server'ın altlık haritaları ve katmanları. Kova boşaldığında harita kesilmez, yavaşlar.

Geo Server#

Geo Server'ın harita sorguları ve georeferanslı haritaları (WMS/WFS). Kova boşaldığında istekler kesilmez, yavaşlar.

Hizmet tanımı isteği (GetCapabilities) ayrıca ve daha sıkı sınırlıdır: ziyaretçi ve kullanıcı için dakikada 1 (kova 2–3), geliştirici için dakikada 5 (kova 15). Bu bilgi seyrek değişir; bir kez alıp saklayın.

ATC Broadcasts#

ATC Surveillance#

Data Link Backend#

Data Link API (D-ATIS ve DCL)#

Sınıra ulaşınca ne olur?#

• Sunucu HTTP 429 (Too Many Requests) yanıtı ve Retry-After başlığı döndürür. Bu başlık kaç saniye sonra yeniden denenebileceğini söyler (çoğunlukla 2 saniye; hizmet tanımı isteğinde 60 saniye).
• ibonav.aero ve İnteraktif Harita bu durumu kendileri yönetir: istek kısa bir süre sonra otomatik olarak yeniden denenir.
• Tile ve Geo Server sorgularında istekler reddedilmez, yavaşlatılır.

Geliştiriciler için öneriler#

• 429 aldığınızda Retry-After başlığındaki süre kadar bekleyip yeniden deneyin; hemen ve art arda yeniden denemeyin.
• Kişisel API anahtarınızla aldığınız 1 saatlik erişim anahtarını süresi dolana kadar yeniden kullanın. Her istekte yeni anahtar almayın; yeni anahtar alma da saatlik olarak sınırlıdır.
• Sık değişmeyen verileri (hizmet tanımları, listeler) önbelleğe alın.
• Aynı veriyi kısa aralıklarla tekrar tekrar istemek yerine verinin güncellenme sıklığına uygun aralıklarla sorgulayın.