# Eczaneler.ORG Nöbetçi Eczane v2 REST API & SDK Ekosistemi
> Türkiye ve KKTC (Kuzey Kıbrıs) genelindeki tüm nöbetçi eczanelere, il/ilçe sorgularına ve GPS koordinat bazlı en yakın eczane lokasyonlarına programatik erişim sağlayan yüksek performanslı RESTful API servisi.

## Genel Bilgiler
- **Base URL**: `https://api.eczaneler.org/v2`
- **Kimlik Doğrulama**: `X-Api-Key: <SENIN_API_ANAHTARIN>` (HTTP Header)
- **Veri Formatı**: JSON (UTF-8)
- **Kapsam**: Türkiye 81 İl, 973 İlçe + KKTC (Lefkoşa, Gazimağusa, Girne, Güzelyurt, İskele, Lefke)
- **Güncelleme Sıklığı**: Her 60 dakikada bir merkezi resmi kaynaklarla otomatik senkronizasyon
- **Önbellek (Cache)**: 10 dakika akıllı önbellek mimarisi
- **Ücretsiz Test Erişimi**: 3 günlük ücretsiz tam yetkili test API anahtarı için Telegram: https://t.me/mehmeterdogannet
- **Dokümantasyon URL**: https://eczaneler.org/nobetci-eczane-api
- **Postman Workspace**: https://www.postman.com/mehmeterdogan/nobetci-eczane-api/overview

## Resmi SDK ve İstemci Paketleri
Tüm SDK'lar açık kaynaklı olup MIT lisansı ile dağıtılmaktadır:

1. **JavaScript / TypeScript / Node.js**:
   - Kurulum: `npm install nobetci-eczane-api`
   - Paket: https://www.npmjs.com/package/nobetci-eczane-api
   - GitHub: https://github.com/mehmeterdogan/nobetci-eczane-api

2. **PHP (Composer)**:
   - Kurulum: `composer require mehmeterdogan/nobetci-eczane-api`
   - Paket: https://packagist.org/packages/mehmeterdogan/nobetci-eczane-api
   - GitHub: https://github.com/mehmeterdogan/nobetci-eczane-api-php

3. **Python (pip)**:
   - Kurulum: `pip install nobetci-eczane-api`
   - Paket: https://pypi.org/project/nobetci-eczane-api/
   - GitHub: https://github.com/mehmeterdogan/nobetci-eczane-api

4. **Go (Golang)**:
   - Kurulum: `go get github.com/mehmeterdogan/nobetci-eczane-api-go`
   - Paket: https://pkg.go.dev/github.com/mehmeterdogan/nobetci-eczane-api-go
   - GitHub: https://github.com/mehmeterdogan/nobetci-eczane-api-go

5. **C# / .NET (NuGet)**:
   - Kurulum: `dotnet add package NobetciEczane.Api`
   - Paket: https://www.nuget.org/packages/NobetciEczane.Api/
   - GitHub: https://github.com/mehmeterdogan/nobetci-eczane-api

6. **Flutter & Dart**:
   - Kurulum: `flutter pub add nobetci_eczane_api`
   - Paket: https://pub.dev/packages/nobetci_eczane_api
   - GitHub: https://github.com/mehmeterdogan/nobetci-eczane-api

7. **Java / Android / Kotlin (JitPack)**:
   - Kurulum (Gradle): `implementation 'com.github.mehmeterdogan:nobetci-eczane-api-java:1.0.1'`
   - Paket: https://jitpack.io/#mehmeterdogan/nobetci-eczane-api-java
   - GitHub: https://github.com/mehmeterdogan/nobetci-eczane-api-java

## Temel API Uç Noktaları (Endpoints)

| Metot | Uç Nokta | Açıklama |
| :--- | :--- | :--- |
| `GET` | `/pharmacies/sentry-pharmacies?limit=50&page=1` | Türkiye ve KKTC genelindeki tüm anlık nöbetçi eczaneleri listeler. |
| `GET` | `/pharmacies/sentry-city-list/{city}?limit=50&page=1` | Belirli bir ildeki nöbetçi eczaneleri listeler (Örn: 34 veya istanbul). |
| `GET` | `/pharmacies/sentry-district-list/{city}/{district}?limit=50&page=1` | Belirli bir ilçedeki nöbetçi eczaneleri listeler (Örn: 34 / 440 veya istanbul / kadikoy). |
| `POST` | `/pharmacies/pharmacies-nearby` | Verilen enlem (lat) ve boylam (lon) koordinatlarına göre en yakın eczaneleri metre sırasıyla getirir. Body: `{"lat": 41.0082, "lon": 28.9784, "is_sentry": 1, "limit": 10}` |
| `GET` | `/pharmacies/cities` | Sistemde kayıtlı tüm 81 il ve KKTC şehir listesini döner. |
| `GET` | `/pharmacies/districts/{city}` | Belirtilen ile ait tüm resmi ilçe listesini döner. |
| `GET` | `/account` | API anahtarına ait hesap sahibi, lisans aktiflik durumu ve geçerlilik tarihlerini döner. |
| `POST` | `/update-whitelist` | API anahtarına tanımlı sunucu IP adresini (veya `5.132.*` gibi wildcard IP) anında günceller. |
| `GET` | `/pharmacies/all-pharmacies/{page}` | Türkiye'deki yaklaşık 30.000+ aktif eczaneyi listeler (Tüm Eczaneler Premium paketi). |

## Hızlı Kod Örnekleri

### JavaScript / Node.js
```javascript
import { EczaneAPI } from 'nobetci-eczane-api';
const api = new EczaneAPI({ apiKey: 'SENIN_API_ANAHTARIN' });
const istanbul = await api.getSentryByCity(34, { limit: 50 });
console.log(istanbul.data);
```

### Python
```python
from nobetci_eczane_api import EczaneAPI
api = EczaneAPI(api_key="SENIN_API_ANAHTARIN")
istanbul = api.get_sentry_by_city(34, limit=50)
print(istanbul.get("data"))
```

### Go (Golang)
```go
package main
import (
    "context"
    "fmt"
    eczane "github.com/mehmeterdogan/nobetci-eczane-api-go"
)
func main() {
    client := eczane.NewClient("SENIN_API_ANAHTARIN")
    pharmacies, _ := client.GetSentryByCity(context.Background(), 34, nil)
    fmt.Println("Bulunan:", len(pharmacies))
}
```

### PHP
```php
use Eczaneler\NobetciEczane\EczaneClient;
$client = new EczaneClient('SENIN_API_ANAHTARIN');
$istanbul = $client->getSentryByCity(34, limit: 50);
print_r($istanbul['data']);
```

### C# / .NET
```csharp
using NobetciEczane.Api;
using var client = new NobetciEczaneClient("SENIN_API_ANAHTARIN");
var istanbul = await client.GetSentryByCityAsync(34, limit: 50);
```

### Flutter / Dart
```dart
import 'package:nobetci_eczane_api/nobetci_eczane_api.dart';
final client = NobetciEczaneClient(apiKey: 'SENIN_API_ANAHTARIN');
final istanbul = await client.getSentryByCity(cityId: 34, limit: 50);
```

### Java / Android
```java
import com.eczaneler.api.EczaneClient;
import com.eczaneler.api.model.Pharmacy;
EczaneClient client = new EczaneClient("SENIN_API_ANAHTARIN");
List<Pharmacy> istanbul = client.getSentryByCity(34, 50, 0);
```

### cURL
```bash
curl --location 'https://api.eczaneler.org/v2/pharmacies/sentry-city-list/34?limit=50' \
  --header 'X-Api-Key: SENIN_API_ANAHTARIN'
```

## Ek Dokümanlar ve Bağlantılar
- Detaylı ve interaktif doküman: https://eczaneler.org/nobetci-eczane-api
- Tam Bağlam Dokümanı: https://eczaneler.org/llms-full.txt
- OpenAPI 3.0 Spesifikasyonu: https://eczaneler.org/openapi.json
- Nöbetçi Noter API Dokümantasyonu: https://eczaneler.org/nobetci-noter-api-docs
- İletişim ve Destek: https://t.me/mehmeterdogannet