İç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ı

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

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.

İçindekiler

Nöbetçi Noter API Dokümantasyonu

Giriş

Kimlik Doğrulama

Endpointler

Nöbetçi Noterler

Tüm Nöbetçi Noterler

İl Bazlı Nöbetçi Noterler

İl Bazlı Noterler

Koordinat Bazlı En Yakın Noterler

İller Listesi

İlçeler Listesi

API Bilgileri

Hata Kodları

Kullanım Limitleri

Fiyatlandırma

Noter API

Örnek Kodlar

JavaScript (Axios) Örneği

Postman Collection

API Anahtarı Talebi

Hızlı Destek İçin Telegram