🚀 API Dokümanı

UdesQuake API, gerçek zamanlı deprem verilerine, sistem durumuna ve istatistiklere erişim sağlar. REST tabanlı API, güvenli ve ölçeklenebilir uygulamalar oluşturmak için tasarlanmıştır.

Hızlı Başlangıç

Başlamak için basit bir istek gönderin:

curl https://api.udesquake.com.tr/api/status

Python ile:

import requests

response = requests.get('https://api.udesquake.com.tr/api/status')
data = response.json()
print(data)
        

🔐 Kimlik Doğrulama

Tüm API isteklerine Bearer token ekleyin:

Authorization: Bearer YOUR_API_TOKEN

💡 Not: Token almanız için kontrol paneline giriş yapın ve API anahtarını oluşturun. Token 30 gün geçerlidir.

Status Endpoint

GET /api/status

Sistem durumunu ve mevcut deprem istatistiklerini döndürür. Kimlik doğrulama gerektirmez.

Request Örneği

curl https://api.udesquake.com.tr/api/status

Response Örneği

{
  "status": "running",
  "active_events": 30,
  "event_count": 850,
  "uptime": "99.9%",
  "sources": ["AFAD", "Kandilli", "EMSC"]
}
                

Response Alanları

Alan	Tür	Açıklama
`status`	string	Sistem durumu: running, maintenance
`active_events`	number	Şu anda aktif deprem olayları
`event_count`	number	Toplam izlenen deprem sayısı
`uptime`	string	Sistem çalışma süresi yüzdesi
`sources`	array	Aktif veri kaynakları listesi

Events Endpoint

GET /api/events

Son deprem olaylarının detaylı listesini döndürür. Bearer token gereklidir.

Request Örneği

curl https://api.udesquake.com.tr/api/events \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"
            

Query Parameters

Parametre	Tür	Açıklama	Default
`limit`	number	Kaç olayı döndüreceği (max: 500)	50
`offset`	number	Kaç olay atlayacağı (pagination)	0
`magnitude_min`	number	Minimum büyüklük filtresi	0
`magnitude_max`	number	Maksimum büyüklük filtresi	10

Response Örneği

{
  "events": [
    {
      "event_id": "eq_2026_07_25_001",
      "timestamp": 1785005995,
      "magnitude": 3.5,
      "latitude": 40.7128,
      "longitude": 29.0833,
      "depth": 18.2,
      "region": "İstanbul",
      "source": "Kandilli"
    }
  ],
  "total": 850,
  "timestamp": 1785005995
}
                

History Endpoint

GET /api/seismic_history

Belirli bir bölge ve zaman aralığı için deprem geçmişini döndürür.

Query Parameters

Parametre	Tür	Açıklama
`region`	string	Bölge adı (örn: İstanbul, İzmir)
`days`	number	Kaç günlük geçmiş (max: 365)

Location Update Endpoint

POST /api/location/update

Kullanıcı konumunu günceller. Konum spoofing algılaması yapılır.

⚠️ Uyarı: Konumun GPS doğruluğu 100 metreden büyük ise (spoofing şüphesi) reddedilir.

Request Body

{
  "latitude": 40.7128,
  "longitude": 29.0833,
  "accuracy": 15.5
}
            

Rate Limiting

API'ye gönderilen istekler aşağıdaki limitlerle sınırlandırılır:

Endpoint	Limit	Pencere
`/api/status`	Sınırsız	-
`/api/events`	100 istek	1 dakika
`/api/location/update`	10 istek	1 dakika
Genel (IP başına)	100 istek	1 dakika

💡 Rate Limit Headers: Response başlıklarında X-RateLimit-Remaining ve X-RateLimit-Reset bulunur.

Hata Kodları

Kod	Mesaj	Açıklama
`200`	OK	İstek başarılı
`400`	Bad Request	Geçersiz parametre
`401`	Unauthorized	Token eksik veya geçersiz
`429`	Too Many Requests	Rate limit aşılı
`500`	Internal Server Error	Sunucu hatası

Webhooks

Deprem olaylarında otomatik bildirimler almak için webhook'lar yapılandırın:

Webhook Payload Örneği

{
  "event_type": "earthquake_detected",
  "timestamp": 1785005995,
  "event": {
    "magnitude": 3.5,
    "region": "İstanbul",
    "latitude": 40.7128,
    "longitude": 29.0833,
    "depth": 18.2
  }
}
        

📞 Destek & İletişim

API ile ilgili sorularınız için bize ulaşın:

Email GitHub Status

📝 Sürüm: API v2.0 | Son Güncelleme: 2026-07-25