Rasathane
Acil

Kurumsal API

API dokümantasyonu

Uçlar, arka planda düzenli olarak yenilenen deprem kayıtlarından yanıt verir; istek anında AFAD ya da Kandilli'ye gidilmez.

V1 son depremler

Değerler AFAD'ın, yoksa USGS'nin (source alanı); yalnız Kandilli'nin bildirdiği deprem verilmez. province: il adı, ilin karası ve kıyısına 50 km'ye kadar deniz. confidence: kaynak eşleşme puanı (0–1), yalnız birden çok birincil kaynakta dolu. Anahtarsız: dakikada 60 istek, en fazla 100 kayıt / 7 gün. API anahtarıyla (x-api-key): dakikada 300 istek, 500 kayıt / 90 gün.

/api/v1/earthquakes?hours=24&limit=50&min_mag=2&province=İzmir

V1 dışa aktarma (CSV / GeoJSON)

Deprem arşivindeki süzgeçlerle aynı parametreler (bas, bit, min_m, il, deniz, kutu, nokta…). Bir istekte en çok 366 gün ve 10.000 kayıt. Yalnız AFAD ve USGS kaynak değerleri; resmî kayıt değildir.

/api/v1/earthquakes/export?bicim=csv&min_m=3

V1 istatistik

30 günlük özet, bölgesel aktivite ve kaynaklı API kullanım senaryoları.

/api/v1/stats

V1 sağlık

Son veri yaşı, fetch durumu ve entegrasyon canlılık kontrolü.

/api/v1/health

Son depremler

Cache üzerinden hızlı son kayıt listesi.

/api/public/earthquakes/latest?limit=10

Zaman aralığı

Saat, büyüklük ve il filtreleriyle kayıt listesi.

/api/public/earthquakes?hours=72&limit=100

İstatistikler

Cache’lenmiş genel deprem istatistikleri.

/api/public/stats

Widget

Harici siteler için gömülebilir son deprem listesi (minMag, province, theme parametreleri).

/widget?minMag=3&theme=dark
Zaman alanları

Tüm uçlarda deprem zamanı (time) UTC olarak ve YYYY-MM-DD HH:mm:ss biçiminde verilir. Türkiye saati (TSİ) için 3 saat ekleyin; Türkiye 2016 yılından beri yıl boyu UTC+3 kullanır.

Anahtarlı kullanım

Daha yüksek limit için API anahtarı verilir; anahtar x-api-key başlığıyla gönderilir ve kullanım sayısı kaydedilir.

API Dokümantasyon | Rasathane