{"id":13607951,"url":"https://github.com/orhanayd/kandilli-rasathanesi-api","last_synced_at":"2025-12-27T11:46:45.276Z","repository":{"id":123600853,"uuid":"211202301","full_name":"orhanayd/kandilli-rasathanesi-api","owner":"orhanayd","description":"Kandilli rasathanesinin son dakika depremler ve tarihe göre deprem listesi için ara API (last minute earthquakes in turkey)","archived":false,"fork":false,"pushed_at":"2025-03-30T03:19:14.000Z","size":15017,"stargazers_count":130,"open_issues_count":0,"forks_count":10,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-03-30T04:20:34.538Z","etag":null,"topics":["api","deprem","deprem-api","depremler","earthquake","earthquake-api","earthquake-data","earthquake-source","geojson","minute-earthquakes","turkey"],"latest_commit_sha":null,"homepage":"https://api.orhanaydogdu.com.tr/deprem/api-docs/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/orhanayd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["orhanayd"]}},"created_at":"2019-09-27T00:13:07.000Z","updated_at":"2025-03-30T03:18:24.000Z","dependencies_parsed_at":"2024-03-16T16:09:15.823Z","dependency_job_id":"3f650b78-e92a-4cab-8152-d3b654afdbf4","html_url":"https://github.com/orhanayd/kandilli-rasathanesi-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhanayd%2Fkandilli-rasathanesi-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhanayd%2Fkandilli-rasathanesi-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhanayd%2Fkandilli-rasathanesi-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhanayd%2Fkandilli-rasathanesi-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/orhanayd","download_url":"https://codeload.github.com/orhanayd/kandilli-rasathanesi-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248581193,"owners_count":21128119,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","deprem","deprem-api","depremler","earthquake","earthquake-api","earthquake-data","earthquake-source","geojson","minute-earthquakes","turkey"],"created_at":"2024-08-01T19:01:23.065Z","updated_at":"2025-12-27T11:46:45.271Z","avatar_url":"https://github.com/orhanayd.png","language":"JavaScript","funding_links":["https://github.com/sponsors/orhanayd"],"categories":["JavaScript"],"sub_categories":[],"readme":"# 🌍 Kandilli Rasathanesi / AFAD API\n\n\u003cdiv align=\"center\"\u003e\n\n[![API Status](https://img.shields.io/badge/API-Active-brightgreen)](https://api.orhanaydogdu.com.tr/deprem/status)\n[![License](https://img.shields.io/badge/License-Custom-orange.svg)](LICENSE)\n[![Node Version](https://img.shields.io/badge/Node.js-%3E%3D14.0.0-green)](https://nodejs.org)\n[![MongoDB](https://img.shields.io/badge/MongoDB-6.0%2B-green)](https://www.mongodb.com/)\n\n**Türkiye'nin en güncel deprem verilerini sunan, ücretsiz ve açık kaynaklı API servisi**\n\n[🔗 Swagger Dokümantasyonu](https://api.orhanaydogdu.com.tr/deprem/api-docs/) | [📊 API Durumu](https://api.orhanaydogdu.com.tr/deprem/status) | [💬 Whatsapp Topluluğu](https://chat.whatsapp.com/KOkShApC4lc9HlMtFFN3kQ)\n\n\u003c/div\u003e\n\n---\n\n## 📋 İçindekiler\n\n- [Hakkında](#-hakkında)\n- [Özellikler](#-özellikler)\n- [Hızlı Başlangıç](#-hızlı-başlangıç)\n- [API Endpoints](#-api-endpoints)\n- [Kurulum](#-kurulum)\n- [Rate Limiting](#-rate-limiting)\n- [Lisans ve Uyarılar](#-lisans-ve-uyarılar)\n\n## 📖 Hakkında\n\nKandilli Rasathanesi API, **Boğaziçi Üniversitesi Kandilli Rasathanesi** ve **AFAD (Afet ve Acil Durum Yönetimi)** tarafından yayınlanan deprem verilerini işleyerek, zenginleştirilmiş ve kolayca kullanılabilir formatta sunan bir RESTful API servisidir.\n\n### Neden Bu API?\n\n- ✅ **Çift Kaynak**: Kandilli ve AFAD verilerini birleştirir\n- ✅ **Gerçek Zamanlı**: Veriler her dakika güncellenir\n- ✅ **Zenginleştirilmiş Veri**: Deprem noktasına en yakın şehirler ve havaalanları\n- ✅ **GeoJSON Desteği**: Harita uygulamalarına kolay entegrasyon\n- ✅ **Ücretsiz**: Ticari olmayan kullanımlar için tamamen ücretsiz\n- ✅ **Güvenilir**: MongoDB ve Redis cache ile yüksek performans\n\n## ✨ Özellikler\n\n### Temel Özellikler\n- 📊 Son 24 saatteki depremler (canlı veri)\n- 📅 Tarih bazlı deprem arşivi\n- 🗺️ GeoJSON formatında konum verileri\n- 🏙️ Depreme en yakın şehir bilgileri\n- ✈️ En yakın havaalanları ve uzaklıkları\n- 👥 Etkilenen bölge nüfus bilgileri\n\n### Teknik Özellikler\n- ⚡ 30 saniyelik önbellekleme (canlı veriler)\n- 🔍 Gelişmiş arama ve filtreleme\n- 📈 İstatistik ve analiz endpointleri\n- 🔐 Rate limiting (dakikada 100 istek)\n- 📖 Swagger/OpenAPI dokümantasyonu\n- 🌍 30+ ülke için sınır verileri\n\n## 🚀 Hızlı Başlangıç - Tüm Kaynaklar (Kandilli/AFAD)\n\n```bash\ncurl https://api.orhanaydogdu.com.tr/deprem\n```\n\n## 📚 API Endpoints\n\n### 📖 Swagger/OpenAPI Dokümantasyonu\n\nDetaylı API dokümantasyonu ve interaktif test arayüzü için:\n\n🔗 **[https://api.orhanaydogdu.com.tr/deprem/api-docs/](https://api.orhanaydogdu.com.tr/deprem/api-docs/)**\n\n### Endpoint Listesi\n\n| Method | Endpoint | Açıklama | Cache | Rate Limit |\n|--------|----------|----------|-------|------------|\n| `GET` | `/deprem/kandilli/live` | Kandilli - Son 24 saat | 30s | 100/dk |\n| `GET` | `/deprem/kandilli/archive` | Kandilli - Tarih aralığı | - | 100/dk |\n| `GET` | `/deprem/afad/live` | AFAD - Son 24 saat | 30s | 100/dk |\n| `GET` | `/deprem/afad/archive` | AFAD - Tarih aralığı | - | 100/dk |\n| `GET` | `/deprem` | Tüm kaynaklar - Son 24 saat | - | 100/dk |\n| `POST` | `/deprem/data/search` | Gelişmiş arama \u0026 filtreleme | - | 100/dk |\n| `GET` | `/deprem/data/get` | Tekil deprem bilgisi | - | 100/dk |\n| `GET` | `/deprem/statics/cities` | Şehir listesi | - | 100/dk |\n| `GET` | `/deprem/status` | API sağlık durumu | - | 100/dk |\n\n---\n\n### 1️⃣ Kandilli - Canlı Veriler\n\n**Endpoint:** `GET /deprem/kandilli/live`\n\n**Açıklama:** Kandilli Rasathanesi'nden son 24 saatteki depremler.\n\n**Query Parametreleri:**\n- `skip` (number, optional): Atlanacak kayıt sayısı (default: 0)\n- `limit` (number, optional): Maksimum kayıt sayısı (default: 50, max: 100)\n\n**Örnek İstek:**\n```bash\ncurl \"https://api.orhanaydogdu.com.tr/deprem/kandilli/live?skip=0\u0026limit=10\"\n```\n\n**Örnek Response:**\n```json\n{\n  \"status\": true,\n  \"httpStatus\": 200,\n  \"serverloadms\": 12,\n  \"metadata\": {\n    \"date_starts\": \"2024-01-07 12:00:00\",\n    \"date_ends\": \"2024-01-08 12:00:00\",\n    \"count\": 10\n  },\n  \"result\": [\n    {\n      \"earthquake_id\": \"ABC123XYZ456\",\n      \"provider\": \"kandilli\",\n      \"title\": \"AKDENIZ\",\n      \"date\": \"2024.01.08 11:45:23\",\n      \"mag\": 3.8,\n      \"depth\": 10.5,\n      \"geojson\": {\n        \"type\": \"Point\",\n        \"coordinates\": [30.5432, 36.1234]\n      },\n      \"location_properties\": {\n        \"closestCity\": {\n          \"name\": \"Antalya\",\n          \"cityCode\": 7,\n          \"distance\": 125430.5,\n          \"population\": 2619832\n        }\n      },\n      \"date_time\": \"2024-01-08 11:45:23\",\n      \"created_at\": 1704710723\n    }\n  ]\n}\n```\n\n---\n\n### 2️⃣ Kandilli - Arşiv\n\n**Endpoint:** `GET /deprem/kandilli/archive`\n\n**Açıklama:** Kandilli Rasathanesi'nden belirli tarih aralığındaki depremler.\n\n**Query Parametreleri:**\n- `date` (string, required): Başlangıç tarihi (YYYY-MM-DD)\n- `date_end` (string, optional): Bitiş tarihi (YYYY-MM-DD, default: bugün)\n- `skip` (number, optional): Atlanacak kayıt sayısı (default: 0)\n- `limit` (number, optional): Maksimum kayıt sayısı (default: 50, max: 100)\n\n**Örnek İstek:**\n```bash\ncurl \"https://api.orhanaydogdu.com.tr/deprem/kandilli/archive?date=2024-01-01\u0026date_end=2024-01-31\u0026limit=50\"\n```\n\n**Örnek Response:**\n```json\n{\n  \"status\": true,\n  \"httpStatus\": 200,\n  \"serverloadms\": 28,\n  \"metadata\": {\n    \"count\": 50\n  },\n  \"result\": [\n    {\n      \"earthquake_id\": \"DEF456GHI789\",\n      \"provider\": \"kandilli\",\n      \"title\": \"GEMLIK KORFEZI (BURSA)\",\n      \"mag\": 4.2,\n      \"depth\": 8.7,\n      \"date_time\": \"2024-01-15 14:23:11\"\n    }\n  ]\n}\n```\n\n---\n\n### 3️⃣ AFAD - Canlı Veriler\n\n**Endpoint:** `GET /deprem/afad/live`\n\n**Açıklama:** AFAD'dan son 24 saatteki depremler.\n\n**Query Parametreleri:**\n- `skip` (number, optional): Atlanacak kayıt sayısı (default: 0)\n- `limit` (number, optional): Maksimum kayıt sayısı (default: 50, max: 100)\n\n**Örnek İstek:**\n```bash\ncurl \"https://api.orhanaydogdu.com.tr/deprem/afad/live?limit=20\"\n```\n\n**Örnek Response:**\n```json\n{\n  \"status\": true,\n  \"httpStatus\": 200,\n  \"serverloadms\": 15,\n  \"metadata\": {\n    \"date_starts\": \"2024-01-07 12:00:00\",\n    \"date_ends\": \"2024-01-08 12:00:00\",\n    \"count\": 20\n  },\n  \"result\": [\n    {\n      \"earthquake_id\": \"JKL789MNO012\",\n      \"provider\": \"afad\",\n      \"title\": \"AEGEAN SEA\",\n      \"mag\": 3.5,\n      \"depth\": 7.2,\n      \"date_time\": \"2024-01-08 10:30:15\"\n    }\n  ]\n}\n```\n\n---\n\n### 4️⃣ AFAD - Arşiv\n\n**Endpoint:** `GET /deprem/afad/archive`\n\n**Açıklama:** AFAD'dan belirli tarih aralığındaki depremler.\n\n**Query Parametreleri:**\n- `date` (string, required): Başlangıç tarihi (YYYY-MM-DD)\n- `date_end` (string, optional): Bitiş tarihi (YYYY-MM-DD, default: bugün)\n- `skip` (number, optional): Atlanacak kayıt sayısı (default: 0)\n- `limit` (number, optional): Maksimum kayıt sayısı (default: 50, max: 100)\n\n**Örnek İstek:**\n```bash\ncurl \"https://api.orhanaydogdu.com.tr/deprem/afad/archive?date=2024-01-01\u0026date_end=2024-01-10\"\n```\n\n**Örnek Response:**\n```json\n{\n  \"status\": true,\n  \"httpStatus\": 200,\n  \"serverloadms\": 22,\n  \"metadata\": {\n    \"count\": 35\n  },\n  \"result\": [\n    {\n      \"earthquake_id\": \"PQR345STU678\",\n      \"provider\": \"afad\",\n      \"title\": \"Ege Denizi\",\n      \"mag\": 4.1,\n      \"depth\": 10.3,\n      \"date_time\": \"2024-01-05 08:15:42\"\n    }\n  ]\n}\n```\n\n---\n\n### 5️⃣ Tüm Kaynaklar (Kombine)\n\n**Endpoint:** `GET /deprem`\n\n**Açıklama:** Tüm veri kaynaklarından (Kandilli + AFAD) son 24 saatteki depremler.\n\n**Query Parametreleri:**\n- `date` (string, optional): Başlangıç tarihi (YYYY-MM-DD, default: 24 saat önce)\n- `date_end` (string, optional): Bitiş tarihi (YYYY-MM-DD, default: şimdi)\n- `skip` (number, optional): Atlanacak kayıt sayısı (default: 0)\n- `limit` (number, optional): Maksimum kayıt sayısı (default: 50, max: 100)\n\n**Örnek İstek:**\n```bash\ncurl \"https://api.orhanaydogdu.com.tr/deprem?limit=30\"\n```\n\n**Örnek Response:**\n```json\n{\n  \"status\": true,\n  \"httpStatus\": 200,\n  \"serverloadms\": 18,\n  \"result\": [\n    {\n      \"earthquake_id\": \"ABC123\",\n      \"provider\": \"kandilli\",\n      \"title\": \"MARMARA DENIZI\",\n      \"mag\": 3.2,\n      \"depth\": 8.5,\n      \"date_time\": \"2024-01-08 10:15:30\"\n    },\n    {\n      \"earthquake_id\": \"XYZ789\",\n      \"provider\": \"afad\",\n      \"title\": \"EGE DENIZI\",\n      \"mag\": 2.8,\n      \"depth\": 6.2,\n      \"date_time\": \"2024-01-08 09:45:12\"\n    }\n  ]\n}\n```\n\n---\n\n### 6️⃣ Gelişmiş Arama\n\n**Endpoint:** `POST /deprem/data/search`\n\n**Açıklama:** Tüm depremler üzerinde gelişmiş filtreleme, konum bazlı arama ve sıralama.\n\n**Request Body:**\n```json\n{\n  \"provider\": \"kandilli\",  // optional: \"kandilli\" veya \"afad\" - kaynak filtresi\n  \"match\": {\n    \"mag\": 4.0,              // optional: Minimum büyüklük\n    \"cityCode\": 34,          // optional: Şehir plaka kodu\n    \"date_starts\": \"2024-01-01 00:00:00\",  // optional: Başlangıç tarihi\n    \"date_ends\": \"2024-01-31 23:59:59\"     // optional: Bitiş tarihi\n  },\n  \"geoNear\": {\n    \"lon\": 29.0,             // optional: Boylam koordinatı\n    \"lat\": 41.0,             // optional: Enlem koordinatı\n    \"radiusMeter\": 100000    // optional: Yarıçap (metre)\n  },\n  \"sort\": \"date_-1\",         // optional: date_1, date_-1, mag_1, mag_-1\n  \"skip\": 0,                 // optional: Sayfalama offset\n  \"limit\": 100               // optional: Max kayıt (default: 100, max: 100 - otomatik sınırlanır)\n}\n```\n\n**Örnek 1 - Büyüklük Filtreleme:**\n```bash\ncurl -X POST https://api.orhanaydogdu.com.tr/deprem/data/search \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"match\": {\"mag\": 4.5},\n    \"sort\": \"mag_-1\",\n    \"limit\": 10\n  }'\n```\n\n**Örnek 2 - Konum Bazlı Arama (İstanbul çevresinde 200km):**\n```bash\ncurl -X POST https://api.orhanaydogdu.com.tr/deprem/data/search \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"geoNear\": {\n      \"lon\": 28.9784,\n      \"lat\": 41.0082,\n      \"radiusMeter\": 200000\n    },\n    \"match\": {\"mag\": 3.0},\n    \"limit\": 20\n  }'\n```\n\n**Örnek 3 - Şehir ve Tarih Filtresi:**\n```bash\ncurl -X POST https://api.orhanaydogdu.com.tr/deprem/data/search \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"match\": {\n      \"cityCode\": 6,\n      \"mag\": 3.0,\n      \"date_starts\": \"2024-01-01 00:00:00\",\n      \"date_ends\": \"2024-01-31 23:59:59\"\n    },\n    \"sort\": \"date_-1\"\n  }'\n```\n\n**Örnek 4 - Kaynak Filtresi (Sadece AFAD):**\n```bash\ncurl -X POST https://api.orhanaydogdu.com.tr/deprem/data/search \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"provider\": \"afad\",\n    \"match\": {\"mag\": 4.0},\n    \"limit\": 30\n  }'\n```\n\n**Örnek Response:**\n```json\n{\n  \"status\": true,\n  \"httpStatus\": 200,\n  \"serverloadms\": 35,\n  \"result\": [\n    {\n      \"earthquake_id\": \"VWX901YZA234\",\n      \"provider\": \"kandilli\",\n      \"title\": \"MARMARA DENIZI\",\n      \"mag\": 4.8,\n      \"depth\": 12.3,\n      \"geojson\": {\n        \"type\": \"Point\",\n        \"coordinates\": [28.5, 40.8]\n      },\n      \"location_properties\": {\n        \"closestCity\": {\n          \"name\": \"İstanbul\",\n          \"cityCode\": 34,\n          \"distance\": 45230.8,\n          \"population\": 15840900\n        },\n        \"closestCities\": [\n          {\"name\": \"İstanbul\", \"cityCode\": 34, \"distance\": 45230.8},\n          {\"name\": \"Tekirdağ\", \"cityCode\": 59, \"distance\": 67890.2}\n        ],\n        \"airports\": [\n          {\n            \"name\": \"İstanbul Havalimanı\",\n            \"code\": \"IST\",\n            \"distance\": 52340.5\n          }\n        ]\n      },\n      \"date_time\": \"2024-01-15 14:23:11\"\n    }\n  ],\n  \"metadata\": {\n    \"total\": 47,\n    \"count\": 10\n  }\n}\n```\n\n---\n\n### 7️⃣ Tekil Deprem Bilgisi\n\n**Endpoint:** `GET /deprem/data/get`\n\n**Açıklama:** Belirli bir earthquake_id'ye sahip depremin detaylı bilgisi.\n\n**Query Parametreleri:**\n- `earthquake_id` (string, required): Deprem ID'si\n\n**Örnek İstek:**\n```bash\ncurl \"https://api.orhanaydogdu.com.tr/deprem/data/get?earthquake_id=EoIrMsfMSC19f\"\n```\n\n**Örnek Response:**\n```json\n{\n  \"status\": true,\n  \"httpStatus\": 200,\n  \"result\": {\n    \"earthquake_id\": \"EoIrMsfMSC19f\",\n    \"provider\": \"kandilli\",\n    \"title\": \"CALIS-ELBISTAN (KAHRAMANMARAS)\",\n    \"date\": \"2023.03.08 02:54:44\",\n    \"mag\": 4.2,\n    \"depth\": 5,\n    \"geojson\": {\n      \"type\": \"Point\",\n      \"coordinates\": [37.0132, 38.1355]\n    },\n    \"location_properties\": {\n      \"closestCity\": {\n        \"name\": \"Kahramanmaraş\",\n        \"cityCode\": 46,\n        \"distance\": 15234.56,\n        \"population\": 1177436\n      },\n      \"epiCenter\": {\n        \"name\": \"Kahramanmaraş\",\n        \"cityCode\": 46,\n        \"population\": 1177436\n      },\n      \"airports\": [\n        {\n          \"distance\": 66757.09,\n          \"name\": \"Kahramanmaraş Havalimanı\",\n          \"code\": \"KCM\"\n        }\n      ]\n    },\n    \"date_time\": \"2023-03-08 02:54:44\",\n    \"created_at\": 1678240484\n  }\n}\n```\n\n---\n\n### 8️⃣ Şehir Listesi\n\n**Endpoint:** `GET /deprem/statics/cities`\n\n**Açıklama:** Türkiye şehir listesi (plaka kodu, isim, nüfus).\n\n**Örnek İstek:**\n```bash\ncurl \"https://api.orhanaydogdu.com.tr/deprem/statics/cities\"\n```\n\n**Örnek Response:**\n```json\n{\n  \"status\": true,\n  \"httpStatus\": 200,\n  \"result\": [\n    {\n      \"cityCode\": 1,\n      \"name\": \"Adana\",\n      \"population\": 2258718\n    },\n    {\n      \"cityCode\": 6,\n      \"name\": \"Ankara\",\n      \"population\": 5663322\n    },\n    {\n      \"cityCode\": 34,\n      \"name\": \"İstanbul\",\n      \"population\": 15840900\n    }\n  ]\n}\n```\n\n---\n\n### 9️⃣ API Sağlık Durumu\n\n**Endpoint:** `GET /deprem/status`\n\n**Açıklama:** API durumu, toplam deprem sayısı ve sistem bilgileri.\n\n**Örnek İstek:**\n```bash\ncurl \"https://api.orhanaydogdu.com.tr/deprem/status\"\n```\n\n**Örnek Response:**\n```json\n{\n  \"status\": true,\n  \"httpStatus\": 200,\n  \"result\": {\n    \"api_status\": \"online\",\n    \"total_earthquakes\": 125847,\n    \"last_update\": \"2024-01-08 12:45:30\",\n    \"uptime_seconds\": 8642341\n  }\n}\n```\n\n## 💻 Kurulum\n\n### Gereksinimler\n- Node.js \u003e= 14.0.0\n- MongoDB \u003e= 6.0\n- PM2 (opsiyonel, production için)\n\n### Adımlar\n\n1. **Projeyi klonlayın**\n```bash\ngit clone https://github.com/orhanayd/kandilli-rasathanesi-api.git\ncd kandilli-rasathanesi-api\n```\n\n2. **Bağımlılıkları yükleyin**\n```bash\nnpm install\n```\n\n3. **Environment değişkenlerini ayarlayın**\n```bash\ncp .env.example .env\n# .env dosyasını düzenleyin\n```\n\n4. **Geliştirme sunucusunu başlatın**\n```bash\nnpm run dev\n```\n\n5. **Production için**\n```bash\nnpm start\n```\n\n\n## 🔒 Rate Limiting\n\nAPI'nin sürdürülebilirliği için rate limiting uygulanmaktadır:\n\n- **Limit**: Dakikada maksimum 100 istek\n- **Kapsam**: IP başına\n- **Bypass**: `BYPASS_IPS` environment değişkeni ile belirli IP'ler muaf tutulabilir\n- **Hata Kodu**: 429 (Too Many Requests)\n\n## 📜 Lisans ve Uyarılar\n\n### 🔒 Lisans Koşulları\n\nBu proje **özel lisans** altında lisanslanmıştır:\n\n- ✅ **Ücretsiz Kullanım**: Eğitim, araştırma ve kişisel amaçlar için\n- ❌ **Ticari Kullanım**: Yazılı izin gerektirir\n- 📄 **Atribusyon**: Projenizde \"Kandilli Rasathanesi API\" referansı gerekli\n- 🚫 **Veri Ticareti**: Deprem verilerinin satışı yasaktır\n\n### ⚠️ Ticari Kullanım Uyarısı\n\n\u003e **ÖNEMLİ UYARI**:\n\u003e 1. Söz konusu bilgi, veri ve haritalar Boğaziçi Üniversitesi Rektörlüğü'nün yazılı izni olmadan ticari amaçlı kullanılamaz.\n\u003e 2. API'nin ticari kullanımı için info@orhanaydogdu.com.tr adresinden detaylı bilgi ve izin alınmalıdır.\n\u003e 3. İzinsiz ticari kullanım yasal işleme tabi olabilir.\n\n### 📝 Lisans Detayları\n\nTam lisans metni için [LICENSE](LICENSE) dosyasına bakınız.\n\n### İletişim\n- 📧 Email: info@orhanaydogdu.com.tr\n- 💬 [Whatsapp Topluluğu](https://chat.whatsapp.com/KOkShApC4lc9HlMtFFN3kQ)\n- 🐛 [GitHub Issues](https://github.com/orhanayd/kandilli-rasathanesi-api/issues)\n\n## 🙏 Teşekkürler\n\n- Boğaziçi Üniversitesi Kandilli Rasathanesi ve Deprem Araştırma Enstitüsü'ne veri sağladıkları için teşekkürler.\n- AFAD (Afet ve Acil Durum Yönetimi Başkanlığı)'a veri sağladıkları için teşekkürler.\n- Bu API'yi kullanan ve geri bildirim sağlayan tüm geliştiricilere teşekkürler.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by [Orhan Aydoğdu](https://github.com/orhanayd)**\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forhanayd%2Fkandilli-rasathanesi-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forhanayd%2Fkandilli-rasathanesi-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forhanayd%2Fkandilli-rasathanesi-api/lists"}