Deprem.cc API Dokümantasyonu

Deprem.cc API, Türkiye ve çevresindeki deprem verilerine programatik erişim sağlayan bir RESTful API hizmetidir.

Temel URL

Genel Bilgiler

• Tüm istekler GET metoduyla yapılmalıdır.
• Yanıtlar JSON formatında döner.
• Tarih formatı ISO 8601 standardındadır (YYYY-MM-DD HH:MM:SS).
• Deprem büyüklükleri ML (Richter) veya Mw (Moment) ölçeğindedir ve kaynak kurumun sağladığı değerdir.

Kimlik Doğrulama

API'ye erişmek için bir API anahtarı gereklidir. API anahtarınızı isteğinize iki şekilde ekleyebilirsiniz:

1. URL Parametresi Olarak

2. Authorization Header Olarak

İstek Limitleri

API istekleriniz, hizmetin sağlıklı çalışması için limitlendirilmiştir. Varsayılan limit günlük 1000 istektir.

Limit aşımı durumunda 429 Too Many Requests yanıt kodu alırsınız. Rate limit hakkında bilgi almak için yanıt başlıklarına bakabilirsiniz:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 985
X-RateLimit-Reset: 1625097600

Daha yüksek istek limitleri için api@deprem.cc adresine başvurabilirsiniz.

Son Depremler Endpoint

Bu endpoint, en son depremleri listeler.

URL

Parametreler

Örnek İstek

Örnek Yanıt

{
  "status": "success",
  "message": "Son depremler başarıyla getirildi.",
  "metadata": {
    "count": 5,
    "generated": "2025-05-31T21:59:59+03:00",
    "params": {
      "limit": 10,
      "min_mag": 4,
      "hours": 48,
      "source": "kandilli"
    }
  },
  "data": [
    {
      "id": "1234",
      "zaman": "2025-05-31 18:30:22",
      "lat": "38.5234",
      "lon": "39.2178",
      "derinlik": "7.6",
      "buyukluk": "4.5",
      "konum": "ELAZIG",
      "kaynak": "kandilli"
    },
    // ... diğer sonuçlar
  ]
}

Deprem Arama Endpoint

Bu endpoint, belirli kriterlere göre deprem araması yapar.

URL

Parametreler

Örnek İstek

İstatistikler Endpoint

Bu endpoint, deprem istatistiklerini sunar.

URL

Parametreler

Örnek İstek

Konum Bazlı Arama Endpoint

Bu endpoint, belirli bir coğrafi konuma yakın depremleri listeler.

URL

Parametreler

Örnek İstek

API Anahtarı Alma

Kod Örnekleri

• JavaScript
• PHP
• Python

// JavaScript ile API kullanımı (fetch kullanarak)
const apiKey = 'YOUR_API_KEY';
const apiUrl = 'https://deprem.cc/api/';

// Son depremler - Büyüklüğü 4+ olanlar
fetch(`${apiUrl}?endpoint=recent&min_mag=4.0&api_key=${apiKey}`)
  .then(response => response.json())
  .then(data => {
    if (data.status === 'success') {
      console.log('Son depremler:', data.data);
      // Verileri işle...
    } else {
      console.error('Hata:', data.message);
    }
  })
  .catch(error => console.error('API hatası:', error));

// PHP ile API kullanımı (cURL)
$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://deprem.cc/api/';

// Son depremler - Büyüklüğü 4+ olanlar
$url = $apiUrl . '?endpoint=recent&min_mag=4.0&api_key=' . $apiKey;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

if ($data['status'] === 'success') {
    echo "Son depremler:\n";
    foreach ($data['data'] as $deprem) {
        echo $deprem['zaman'] . " - " . $deprem['konum'] . " - Büyüklük: " . $deprem['buyukluk'] . "\n";
    }
} else {
    echo "Hata: " . $data['message'];
}

# Python ile API kullanımı (requests kütüphanesi)
import requests
import json

api_key = 'YOUR_API_KEY'
api_url = 'https://deprem.cc/api/'

# Son depremler - Büyüklüğü 4+ olanlar
params = {
    'endpoint': 'recent',
    'min_mag': 4.0,
    'api_key': api_key
}

response = requests.get(api_url, params=params)
data = response.json()

if data['status'] == 'success':
    print('Son depremler:')
    for deprem in data['data']:
        print(f"{deprem['zaman']} - {deprem['konum']} - Büyüklük: {deprem['buyukluk']}")
else:
    print(f"Hata: {data['message']}")

Hata Kodları