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

İçindekiler

Nöbetçi Noter API Dokümantasyonu

Giriş

Eczaneler.ORG Noter API'si, Türkiye'deki noter ve nöbetçi noter verilerine programatik erişim sağlar. Bu API ile noter arama, nöbetçi noter listeleme ve noter 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.

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

Base URL:

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

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 Noterler

Tüm Nöbetçi Noterler

GET/all-sentry-notaries/{date}/{page}

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

Parametreler:

  • date: Tarih formatı YYYY-MM-DD (örn. 2025-07-06)
  • page: Sayfa numarası (varsayılan: 1)

Örnek Yanıt:

{
  "data": [
    {
      "name": "Sincan 7. Noterliği",
      "phone": "+903125120007",
      "phone_formatted": "+90 312 512 00 07",
      "city": "Ankara",
      "district": "Sincan",
      "address": "Istasyon Mah. Çatalca Cad. No:72 15 Sincan Ankara",
      "sentry_date": "2025-07-06",
      "sentry_date_format": "06 Temmuz 2025",
      "note": "Nöbetçi Noterlik Çalışma Saatleri: Cumartesi 09:00-16:00 / Pazar 10:00-14:00",
      "coordinates": {
        "lat": "32.58135",
        "lon": "39.97604"
      }
    }
  ],
  "pagination": {
    "total": 500,
    "per_page": "12",
    "current_page": "1",
    "total_pages": 42,
    "has_more": true,
    "prev_page": null,
    "next_page": 2
  }
}

İl Bazlı Nöbetçi Noterler

GET/sentry-city-notaries/{date}/{city}

Belirli bir ildeki nöbetçi noterleri listeler.

Parametreler:

  • date: Tarih formatı YYYY-MM-DD (örn. 2025-07-06)
  • city: İl adı (örn. adana)

Örnek Yanıt:

[
  {
    "name": "Adana 6. Noterliği",
    "phone": "+903223213414",
    "phone_formatted": "+90 322 321 34 14",
    "city": "Adana",
    "district": "Yüreğir",
    "address": "Cumhuriyet Mah. Ilbey Güney Cad. 779. Sok K:2 N:1 B Yüreğir Adana",
    "sentry_date": "2025-07-06",
    "sentry_date_format": "06 Temmuz 2025",
    "note": "Nöbetçi Noterlik Çalışma Saatleri: Cumartesi 09:00-16:00 / Pazar 10:00-14:00",
    "coordinates": {
      "lat": "35.340378",
      "lon": "36.986819"
    }
  }
]

İl Bazlı Noterler

GET/city-notaries/{city}/{page}

Belirli bir ildeki tüm noterleri listeler (nöbetçi olmayanlar dahil).

Parametreler:

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

Örnek Yanıt:

{
  "data": [
    {
      "name": "Adana 22",
      "phone": "+903222473430",
      "phone_formatted": "+90 322 247 34 30",
      "city": "Adana",
      "district": "Çukurova",
      "address": "Kurttepe Mah. Sülayman Demirel Bul. Ali Tuna Apt. No:90 B Çukurova Adana",
      "note": "Nöbetçi Noterlik Çalışma Saatleri: Cumartesi 09:00-16:00 / Pazar 10:00-14:00",
      "coordinates": {
        "lat": "35.276365",
        "lon": "37.054884"
      }
    }
  ],
  "pagination": {
    "total": 48,
    "per_page": "12",
    "current_page": "1",
    "total_pages": 4,
    "has_more": true,
    "prev_page": null,
    "next_page": 2
  }
}

Koordinat Bazlı En Yakın Noterler

POST/notaries-nearby

Belirli bir konuma en yakın 10 adet noter listeler.

Parametreler:

  • lat: Enlem (latitude) koordinatı (örn. 36.986819)
  • lon: Boylam (longitude) koordinatı (örn. 35.340378)

Örnek Yanıt:

[
  {
    "name": "Adana 9. Noterliği",
    "phone": "+903224595353",
    "phone_formatted": "+90 322 459 53 53",
    "city": "Adana",
    "district": "Seyhan",
    "address": "Atatürk Cad. Kayahan Ap.k:1 D:3 01060 Seyhan Adana",
    "is_sentry ": true,
    "sentry_date": "2025-07-12",
    "sentry_date_format": "12 Temmuz 2025",
    "note": "Nöbetçi Noterlik Çalışma Saatleri: Cumartesi 09:00-16:00 / Pazar 10:00-14:00",
    "distance_km": 0.2,
    "coordinates": {
      "lat": "35.325313",
      "lon": "36.992358"
    }
  },
  {
    "name": "Adana 7. Noterliği",
    "phone": "+903223513430",
    "phone_formatted": "+90 322 351 34 30",
    "city": "Adana",
    "district": "Seyhan",
    "address": "Inönü Cad. 27031 Sokak No:3 1 (Eski Adliye Karşısı) 01010 Seyhan Adana",
    "is_sentry ": true,
    "sentry_date": "2025-07-12",
    "sentry_date_format": "12 Temmuz 2025",
    "note": "Nöbetçi Noterlik Çalışma Saatleri: Cumartesi 09:00-16:00 / Pazar 10:00-14:00",
    "distance_km": 0.28,
    "coordinates": {
      "lat": "35.327164",
      "lon": "36.990237"
    }
  }
]

İller Listesi

GET/cities

Türkiye'deki tüm illeri listeler.

Örnek Yanıt:

{
  "cities": [
    {
      "name": "Adana",
      "slug": "adana"
    },
    {
      "name": "İstanbul",
      "slug": "istanbul"
    }
  ]
}

İ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": "Adana",
      "city_slug": "adana",
      "district_name": "Seyhan",
      "district_slug": "adana-seyhan"
    }
  ]
}

API Bilgileri

GET/api-account-info

API hesabı hakkında bilgileri ve istatistikleri getirir.

Örnek Yanıt:

{
  "api_info": {
    "full_name": "Mehmet Erdoğan",
    "phone": "0543 123 0000",
    "email": "[email protected]",
    "website": "https://demo.com",
    "is_active": "active",
    "total_request": 283,
    "expires_at": "2025-07-10 00:00:00"
  }
}

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

Noter 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

Noter API

₺750
yıllık
  • Türkiye genelindeki tüm nöbetçi noterler
  • İl bazlı nöbetçi noter listeleme
  • Tüm illerdeki noter listeleri
  • Koordinat bazlı en yakın noterler
  • Sınırsız API isteği
  • JSON formatında veri
  • Tüm endpoint'lere erişim

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

Örnek Kodlar

JavaScript (Axios) Örneği

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

// Tüm nöbetçi noterleri listeleme
axios.get('https://api.eczaneler.org/api/v2/notaries/all-sentry-notaries/2025-07-06/1', {
  headers: {
    'X-Api-Key': 'sizin_api_anahtariniz'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Hata:', error);
});

// İl bazlı nöbetçi noterleri listeleme
axios.get('https://api.eczaneler.org/api/v2/notaries/sentry-city-notaries/2025-07-06/istanbul', {
  headers: {
    'X-Api-Key': 'sizin_api_anahtariniz'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Hata:', error);
});

Postman Collection

Tüm endpoint'leri Postman'de test etmek için collection dosyasını indirin.

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.

Lütfen epostayı doğru giriniz. Çünkü bu adrese geri dönüş yapılacaktır.

Lütfen telefon numarasını doğru giriniz. Çünkü bu adrese geri dönüş yapılacaktır.

Hızlı Destek İçin Telegram

API entegrasyonu ve teknik sorularınız için Telegram üzerinden bize ulaşabilirsiniz. Size hızlıca yardımcı olalım!

Telegram'da Bize Ulaşın