API Dokümantasyonu

Talivio Celestial Seismic Engine v3.0 — RESTful JSON API

Tüm endpointleri interaktif olarak deneyimlemek, istek/yanıt şemalarını incelemek ve canlı test yapmak için Swagger UI'ı kullanın.

📄 Swagger UI →

Base URL: http://127.0.0.1:8000 — sunucu taraflı API adresi. Doğrudan API çağrısı yapmak istiyorsanız bu adresi kullanın. Tüm endpointler Content-Type: application/json döner.

Tahmin (Prediction)

Metod	Endpoint	Açıklama
POST	/api/v1/predict	Tek nokta için deprem olasılığı. Body: `{"lat": 41.0, "lon": 29.0, "date": "YYYY-MM-DD"}`
POST	/api/v1/predict_region	Bölgesel ısı haritası (grid tarama). Body: `{"min_lat":…, "max_lat":…, "min_lng":…, "max_lng":…, "steps": 20, "date_str": "…"}`

Göksel İndeks (Celestial)

Metod	Endpoint	Açıklama
GET	/api/v1/celestial/{date}	Belirli tarih için tam göksel indeks: ay evresi, gel-git stresi, perige/apoge, syzygy durumu.
GET	/api/v1/celestial/windows	Yüksek risk pencerelerini listele. Query: `?start=YYYY-MM-DD&end=YYYY-MM-DD`

Bölgeler (Regions)

Metod	Endpoint	Açıklama
GET	/api/v1/regions	Tüm aktif izleme bölgelerini listele.
POST	/api/v1/regions	Yeni bölge ekle (otomatik onboarding: GEM fayları, GNSS, USGS). Body: `{"name_tr":…, "name_en":…, "lat":…, "lon":…, "radius_km": 200}`
GET	/api/v1/regions/{id}/risk	Belirli bölge için anlık risk skoru.

ML Model

Metod	Endpoint	Açıklama
GET	/api/v1/ml/status	Aktif model versiyonu, ROC-AUC, feature importances, son eğitim tarihi.
GET	/api/v1/ml/model-card	Otomatik oluşturulmuş model kartı (metodoloji, sınırlılıklar, metrikler).
POST	/api/v1/ml/retrain	Modeli yeniden eğit (arka planda). Champion/Challenger karşılaştırması uygulanır.
GET	/api/v1/ml/backtest	Son backtest raporu (yıl-yıl doğruluk, ROC-AUC timeline).

Veri (Data)

Metod	Endpoint	Açıklama
GET	/api/v1/data/usgs/recent	Son USGS depremleri. Query: `?days=30&min_mag=4.5&limit=100`
POST	/api/v1/data/usgs/ingest	USGS ingestion'ı manuel tetikle (arka plan job). Query: `?days=30&min_mag=4.5`
GET	/api/v1/data/usgs/verify	Tarih aralığı ve bölge için gerçek deprem doğrulaması. Query: `?start_date=…&end_date=…&lat=…&lon=…&radius_km=250`
GET	/api/v1/data/gnss/stations	GNSS istasyonları (strain rate verileriyle). Query: `?lat=…&lon=…&radius_km=500`
POST	/api/v1/data/gnss/ingest	NGL GNSS verisi ingestion'ı manuel tetikle (arka plan job).
GET	/api/v1/data/ingest/{job_id}	Arka plan ingestion job durumunu sorgula.
GET	/api/v1/data/faults	Fay segmentleri (harita katmanı). Query: `?region_id=…&limit=500`. Polyline koordinatları içerir.
GET	/api/v1/pipeline/status	Scheduler durumu, son USGS/GNSS çekim zamanları, veri tazeliği sorunları.

Sistem

Metod	Endpoint	Açıklama
GET	/api/v1/health	Sistem sağlığı: DB durumu, ML model, GNSS/fay servisleri, scheduler, veri tazeliği.