Nöbetçi Eczane API Dokümantasyonu | Eczaneler.ORG

İçindekiler

Nöbetçi 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.

Diğer API Servisleri: Nöbetçi noter verilerine erişmek için Nöbetçi Noter API Dokümantasyonu sayfasını ziyaret edebilirsiniz.

Kimlik Doğrulama

Tüm API istekleri için bir API anahtarı gereklidir. API anahtarı almak içinaşağıdaki telegram kanalı üzerinden iletişime geçebilirsiniz.

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

X-Api-Key: API_KEY_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/pharmacies/sentry-pharmacies/{page}

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

Parametreler:

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

Örnek Yanıt:

{
  "data": [
    {
      "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",
      "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": "25",
    "current_page": "1",
    "total_pages": 2,
    "has_more": true,
    "prev_page": null,
    "next_page": 2
  }
}

İl Bazlı Nöbetçi Eczaneler

GET/pharmacies/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": [
    {
      "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",
      "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": "25",
    "current_page": "1",
    "total_pages": 1,
    "has_more": false,
    "prev_page": null,
    "next_page": null
  }
}

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

GET/pharmacies/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": [
    {
      "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",
      "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": "25",
    "current_page": "1",
    "total_pages": 1,
    "has_more": false,
    "prev_page": null,
    "next_page": null
  }
}

Koordinat Bazlı En Yakın Eczaneler

POST/pharmacies/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/pharmacies/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/pharmacies/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": "adalar",
      "pharmacy_count": 10
    },
    {
      "city_name": "İstanbul",
      "city_slug": "istanbul",
      "district_name": "Arnavutköy",
      "district_slug": "arnavutkoy",
      "pharmacy_count": 29
    }
  ]
}

API Bilgileri

GET/pharmacies/api-info

API hakkında genel bilgileri ve istatistikleri getirir.

Örnek Yanıt:

{
  "api_info": {
    "full_name": "Mehmet Erdoğan",
    "phone": "90 543 000 0000",
    "email": "[email protected]",
    "is_active": "active",
    "total_request": 25,
    "expires_at": "2025-07-20",
    "website": "https://mehmeterdogan.net",
    "remaining_days": 5
  }
}

Premium Eczane APIPREMIUM

Tüm Eczaneler (Premium)

GET/pharmacies/all-pharmacies/{page}

Türkiye'deki tüm eczaneleri listeler. Bu özellik extra ücretli bir özellik olarak sunulur. Standart API hizmeti satın aldıktan sonra bu hizmeti satın alabilirsiniz. Ortalama 29.000 eczane kaydı bulunmaktadır.

Parametreler:

  • page: Sayfa numarası (varsayılan: 1, sayfa başına 50 kayıt)

Örnek Yanıt:

{
  "data": [
    {
      "name": "Çalı Derman Eczanesi",
      "phone": "+902244823218",
      "city": "Bursa",
      "district": "Nilüfer",
      "address": "ÇALI MAH. BURSA CAD. NO:3(İCAP NÖBETÇİDİR)",
      "sentry_date": "2025-07-14",
      "is_sentry": true,
      "owner_fullname": "",
      "map_link": "",
      "workingHours": "08:00 - 23:59",
      "updated_at": "2025-07-14 14:30:03",
      "note": "14.07.2025 18:00 / 14.07.2025 20:00  arası nöbetçidir.",
      "coordinates": {
        "lat": "40.168661406877135",
        "lon": "28.919362404144998"
      }
    }
  ],
  "pagination": {
    "total": 28291,
    "per_page": 50,
    "current_page": 1,
    "total_pages": 566,
    "has_more": true,
    "prev_page": null,
    "next_page": 2
  }
}

Hata Kodları

KodAçıklamaÖrnek
200Başarılı{ "success": true, ... }
406Hata Mesajı{ "success": false, "error": "Geçersiz parametre" }
401Kimlik doğrulama hatası{ "success": false, "error": "API anahtarı eksik" }
404Kaynak bulunamadı{ "success": false, "error": "Kaynak bulunamadı" }
500Sunucu 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
  • IP kısıtlaması bulunmaktadır. Yani sadece izin verilen IP adreslerinden istek yapabilirsiniz.
  • 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

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

axios.get('API_BASE_URL/pharmacies/sentry-pharmacies/1', {
  headers: {
    'X-Api-Key': 'API_KEY_ANAHTARINIZ'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Hata:', error);
});

Sıkça Sorulan Sorular

API Ücretli mi?

Evet, API servisi ücretli ve yıllık olarak hesaplanır.

API servisini test edebilir miyiz?

Evet, Telegram üzerinden iletişime geçildiğinde 3 günlük test API oluşturulup tarafınıza eposta ile gönderilir.

API servisinde kısıtlama var mı?

Evet, API servisindeki IP kısıtlaması var. API servisini satın aldıktan sonra kayıt esnasında verilen IP adresi üzerinden API servisine erişilebilir.

API servisinde request limit var mı?

Hayır, normal şartlarda limit yok ama yüksek kullanımı dengelemek için rate limit uygulanır. Standart kullanımda bu limite takılma pek olmaz.

Sistemde cache var mı?

Evet, sistemde 10 dakikalık cache var.

İletişim

Telegram Üzerinden İletişim

API anahtarı talebi, test API'si ve teknik destek için Telegram üzerinden bizimle iletişime geçebilirsiniz.

Telegram'da İletişime Geç