API Dokümantasyonu

81 ilin nöbetçi eczanelerine programatik erişim. Kayıt olun, API anahtarınızı alın ve aşağıdaki üç uç noktayla veriye ulaşın.

Ücretsiz kayıt ol

Kimlik doğrulama

Her istekte anahtarınızı X-API-Key başlığında gönderin. Anahtarınızı kayıt sırasında bir kez görürsünüz; yenilerini Hesap sayfasından yönetebilirsiniz.

curl "https://nobetci-eczane.bildirium.com/v1/pharmacies?city=ankara&district=cankaya" \
  -H "X-API-Key: npe_ANAHTARINIZ"

Uç noktalar

GET /v1/cities

81 ilin katalogu. slug değerleri diğer uç noktalarda kullanılır.

[
  { "code": 1, "name": "ADANA", "slug": "adana" },
  { "code": 2, "name": "ADIYAMAN", "slug": "adiyaman" }
]

GET /v1/cities/{city}/districts

Bir ilin ilçe katalogu — aynı { code, name, slug } yapısı.

GET /v1/pharmacies

Nöbetçi eczane listesi.

Parametre	Zorunlu	Açıklama
city	evet	İl slug'ı (ör. `ankara`)
district	hayır	İlçe slug'ı — verilirse liste ilçeye daraltılır
date	hayır	`today` (varsayılan) veya `tomorrow`

{
  "meta": {
    "city": { "code": 6, "name": "ANKARA", "slug": "ankara" },
    "district": { "code": 1231, "name": "ÇANKAYA", "slug": "cankaya" },
    "date": "2026-07-15",
    "count": 2,
    "fetched_at": "2026-07-15T13:21:55.753Z",
    "stale": false
  },
  "pharmacies": [
    {
      "name": "KIVANÇ",
      "address": "REMZİ OĞUZ ARIK MAH. TUNALI HİLMİ CAD. NO:66/A",
      "phone": "+903124675566",
      "district": { "code": 1231, "name": "ÇANKAYA", "slug": "cankaya" },
      "location": { "lat": 39.9042, "lng": 32.8619 },
      "duty_start": "2026-07-15T18:30:00+03:00",
      "duty_end": "2026-07-16T08:30:00+03:00",
      "notes": null
    }
  ]
}

name — eczane adı, "ECZANESİ" eki olmadan.
phone — +90… biçiminde ya da null.
location, duty_start, duty_end, notes — kaynakta yoksa null.
meta.stale — true ise güncel veri alınamadı, en son başarılı liste dönüyor (fetched_at anına ait).

Hatalar

Hatalar RFC 7807 biçimindedir: { "status", "title", "detail", "type" }

401	Eksik ya da geçersiz API anahtarı
404	Bilinmeyen il veya ilçe slug'ı
429	Hız limiti ya da günlük kota aşıldı
503	Veri şu an sağlanamıyor — kısa süre sonra tekrar deneyin

Limitler

Varsayılan olarak saniyede 10 istek ve günlük 1000 istek. Kullanımınızı ve kalan kotanızı Hesap sayfasından izleyebilirsiniz. Yanıtlar il + gün bazında önbelleklenir; aynı ili gün içinde tekrar sorgulamak hızlıdır ve kotanızdan düşmeye devam eder — istemci tarafında da önbelleklemeniz önerilir.