İçindekiler

Eczane API Dokümantasyonu

Giriş

Eczaneler.ORG Eczane API'si, Türkiye'deki eczane ve nöbetçi eczane verilerine programatik erişim sağlar. Bu API ile eczane arama, nöbetçi eczane listeleme ve eczane detay bilgilerine erişebilirsiniz.

API'miz RESTful prensiplere göre tasarlanmıştır ve JSON formatında veri döndürür. Tüm istekler HTTPS üzerinden yapılmalıdır.

API isteklerinizi gerçekleştirmek için axios kütüphanesini kullanmanızı öneririz.

Base URL:

https://api.eczaneler.org/api/v2/pharmacies

Kimlik Doğrulama

Tüm API istekleri için bir API anahtarı gereklidir. API anahtarı almak içinaşağıdaki formu doldurun.

API anahtarınızı her istekte header olarak ekleyin:

X-Api-Key: sizin_api_anahtariniz

API anahtarınızı güvenli bir şekilde saklayın ve paylaşmayın. Güvenlik ihlali durumunda API anahtarınız devre dışı bırakılabilir.

Endpointler

Nöbetçi Eczaneler

Tüm Nöbetçi Eczaneler

GET/sentry-pharmacies/{page}

Türkiye genelindeki tüm nöbetçi eczaneleri listeler.

Parametreler:

page: Sayfa numarası (varsayılan: 1)

Örnek Yanıt:

{
  "data": [
    {
      "id": 649,
      "slug": "adana-cukurova-aygul-eczanesi",
      "title": "Adana Çukurova Aygül Eczanesi",
      "name": "Aygül Eczanesi",
      "phone": "+905070251485",
      "phone_formatted": "+90 507 025 14 85",
      "city": "Adana",
      "district": "Çukurova",
      "address": "MAHFESIĞMAZ MAH.ŞEHİTLER BULV. KAROL SİTESİ NO:14/L",
      "view_count": 0,
      "sentry_date": "2025-06-22",
      "is_sentry": true,
      "is_open": true,
      "workingHours": "08:00 - 23:59",
      "updated_at": "2025-06-22 00:03:37",
      "note": "",
      "coordinates": {
        "lat": "37.03424072",
        "lon": "35.30810547"
      }
    }
  ],
  "pagination": {
    "total": 13,
    "per_page": "12",
    "current_page": "1",
    "total_pages": 2,
    "has_more": true,
    "prev_page": null,
    "next_page": 2
  }
}

İl Bazlı Nöbetçi Eczaneler

GET/sentry-city-list/{city}/{page}

Belirli bir ildeki nöbetçi eczaneleri listeler.

Parametreler:

city: İl adı (örn. adana)
page: Sayfa numarası (varsayılan: 1)

Örnek Yanıt:

{
  "data": [
    {
      "id": 649,
      "slug": "adana-cukurova-aygul-eczanesi",
      "title": "Adana Çukurova Aygül Eczanesi",
      "name": "Aygül Eczanesi",
      "phone": "+905070251485",
      "phone_formatted": "+90 507 025 14 85",
      "city": "Adana",
      "district": "Çukurova",
      "address": "MAHFESIĞMAZ MAH.ŞEHİTLER BULV. KAROL SİTESİ NO:14/L",
      "view_count": 0,
      "sentry_date": "2025-06-22",
      "is_sentry": true,
      "is_open": true,
      "workingHours": "08:00 - 23:59",
      "updated_at": "2025-06-22 00:03:37",
      "note": "",
      "coordinates": {
        "lat": "37.03424072",
        "lon": "35.30810547"
      }
    }
  ],
  "pagination": {
    "total": 5,
    "per_page": "12",
    "current_page": "1",
    "total_pages": 1,
    "has_more": false,
    "prev_page": null,
    "next_page": null
  }
}

İlçe Bazlı Nöbetçi Eczaneler

GET/sentry-district-list/{city}/{district}/{page}

Belirli bir ildeki belirli bir ilçenin nöbetçi eczanelerini listeler.

Parametreler:

city: İl adı (örn. adana)
district: İlçe adı (örn. cukurova)
page: Sayfa numarası (varsayılan: 1)

Örnek Yanıt:

{
  "data": [
    {
      "id": 649,
      "slug": "adana-cukurova-aygul-eczanesi",
      "title": "Adana Çukurova Aygül Eczanesi",
      "name": "Aygül Eczanesi",
      "phone": "+905070251485",
      "phone_formatted": "+90 507 025 14 85",
      "city": "Adana",
      "district": "Çukurova",
      "address": "MAHFESIĞMAZ MAH.ŞEHİTLER BULV. KAROL SİTESİ NO:14/L",
      "view_count": 0,
      "sentry_date": "2025-06-22",
      "is_sentry": true,
      "is_open": true,
      "workingHours": "08:00 - 23:59",
      "updated_at": "2025-06-22 00:03:37",
      "note": "",
      "coordinates": {
        "lat": "37.03424072",
        "lon": "35.30810547"
      }
    }
  ],
  "pagination": {
    "total": 3,
    "per_page": "12",
    "current_page": "1",
    "total_pages": 1,
    "has_more": false,
    "prev_page": null,
    "next_page": null
  }
}

Koordinat Bazlı En Yakın Eczaneler

POST/pharmacies-nearby

Belirli bir konuma en yakın 20 adet eczaneyi listeler.

Parametreler:

lat: Enlem (latitude) koordinatı (örn. 41.0082)
lon: Boylam (longitude) koordinatı (örn. 28.9784)

Örnek Yanıt:

{
  "data": [
    {
      "name": "Okur Eczanesi",
      "phone": "+903288143420",
      "city": "Osmaniye",
      "district": "Merkez",
      "address": "BÜYÜK CAMİİ CİVARI ÇINARLI KAHVE KARŞISI",
      "sentry_date": "2025-06-25",
      "is_sentry": false,
      "owner_fullname": "",
      "map_link": "",
      "workingHours": "closed",
      "updated_at": "2025-06-25 13:38:53",
      "note": "",
      "coordinates": {
        "lat": "37.07295400",
        "lon": "36.25217000"
      },
      "distance_km": 0.74
    }
  ]
}

Genel API

İller Listesi

GET/cities

Türkiye'deki tüm illeri listeler.

Örnek Yanıt:

{
  "cities": [
    {
      "id": 1,
      "name": "Adana",
      "slug": "adana",
      "pharmacy_count": 450
    },
    {
      "id": 2,
      "name": "İstanbul",
      "slug": "istanbul",
      "pharmacy_count": 3200
    }
  ]
}

İlçeler Listesi

GET/districts/{city}

Belirli bir ildeki tüm ilçeleri listeler.

Parametreler:

city: İl adı (örn. adana)

Örnek Yanıt:

{
  "districts": [
    {
      "city_name": "İstanbul",
      "city_slug": "istanbul",
      "district_name": "Adalar",
      "district_slug": "istanbul-adalar",
      "pharmacy_count": 10
    },
    {
      "city_name": "İstanbul",
      "city_slug": "istanbul",
      "district_name": "Arnavutköy",
      "district_slug": "istanbul-arnavutkoy",
      "pharmacy_count": 29
    }
  ]
}

API Bilgileri

GET/api-info

API hakkında genel bilgileri ve istatistikleri getirir.

Örnek Yanıt:

{
  "api_info": {
    "full_name": "Mehmet Erdoğan",
    "phone": "0543  000 00 00",
    "email": "[email protected]",
    "website": "https://demo.com",
    "is_active": "active",
    "total_request": 1000,
    "expires_at": "2025-06-30 00:00:00"
  }
}

Hata Kodları

Kod	Açıklama	Örnek
200	Başarılı	`{ "success": true, ... }`
406	Hata Mesajı	`{ "success": false, "error": "Geçersiz parametre" }`
401	Kimlik doğrulama hatası	`{ "success": false, "error": "API anahtarı eksik" }`
404	Kaynak bulunamadı	`{ "success": false, "error": "Kaynak bulunamadı" }`
500	Sunucu hatası	`{ "success": false, "error": "Sunucu hatası" }`

Kullanım Limitleri

Eczane API'sinde kullanım limiti bulunmamaktadır!

İstediğiniz kadar API isteği yapabilirsiniz. Sadece makul kullanım kurallarına uymanızı rica ediyoruz.

Serviste Cache mekanizması bulunmaktadır. Bu sebeple aynı istekleri tekrar yapmayınız.

API kullanımında dikkat edilmesi gerekenler:

Sunucuya aşırı yük bindirmemek için makul aralıklarla istek yapın
Gereksiz isteklerden kaçının
Verileri cache'leyerek tekrar istek yapmaktan kaçının
Toplu veri çekme işlemlerinde sayfalama kullanın
Normal şartlarda rate limit kısıtlaması yoktur. Ancak sürekli yüksek miktarda istek yapılması durumunda bir süreliğine ip adresiniz engellenir veya API anahtarınız devre dışı bırakılabilir.
API anahtarınızı güvenli bir şekilde saklayın ve paylaşmayın. Güvenlik ihlali durumunda API anahtarınız devre dışı bırakılabilir.

Fiyatlandırma

Tüm Nöbetçi Eczaneler

₺1.000

yıllık

Türkiye ve Kıbrısgenelindeki tüm nöbetçi eczaneler
Sınırsız API isteği
Sayfalama desteği
JSON formatında veri

Belirli İl Nöbetçi Eczaneler

₺500

yıllık

Belirli bir ildeki nöbetçi eczaneler
İlçe bazlı filtreleme
Sınırsız API isteği
Detaylı eczane bilgileri

Not: Fiyatlar yıllık olarak hesaplanır ve ödeme yapıldıktan sonra API anahtar bilgileri paylaşılır.

Örnek Kodlar

Postman Collection

Tüm API endpoint'lerini içeren Postman collection'ını indirin

// npm install axios
import axios from 'axios';

axios.get('https://api.eczaneler.org/api/v2/pharmacies/sentry-pharmacies/1', {
  headers: {
    'X-Api-Key': 'sizin_api_anahtariniz'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Hata:', error);
});

API Anahtarı Talebi

Eczaneler.ORG API'sini kullanmak için bir API anahtarına ihtiyacınız vardır. Aşağıdaki formu doldurarak API anahtarı talebinde bulunabilirsiniz.