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://api-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

Kullanım şartı

Veri bilgilendirme amaçlıdır ve garanti edilmez. Bu API'yi bir uygulamada kullanıyorsanız, kullanıcıya eczaneye gitmeden önce telefonla arayıp teyit etmesi gerektiğini gösterin. Sorumluluğun sınırları için yasal uyarı sayfasına bakın.

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.