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

Diğer API Servisleri: Nöbetçi eczane verilerine erişmek için Nöbetçi Eczane 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 Noterler

Tüm Nöbetçi Noterler

GET/notaries/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": "25",
    "current_page": "1",
    "total_pages": 42,
    "has_more": true,
    "prev_page": null,
    "next_page": 2
  }
}

İl Bazlı Nöbetçi Noterler

GET/notaries/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/notaries/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": "25",
    "current_page": "1",
    "total_pages": 4,
    "has_more": true,
    "prev_page": null,
    "next_page": 2
  }
}

Koordinat Bazlı En Yakın Noterler

POST/notaries/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/notaries/cities

Türkiye'deki tüm illeri listeler.

Örnek Yanıt:

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

İlçeler Listesi

GET/notaries/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": "seyhan"
    }
  ]
}

API Bilgileri

GET/notaries/api-account-info

API hesabı hakkında 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 Noter APIPREMIUM

Tüm Noterler (Premium)

GET/notaries/all-notaries/{page}

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

Parametreler:

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

Örnek Yanıt:

{
  "data": [
    {
      "name": "Adana 1. Noterliği",
      "phone": "+903223512450",
      "phone_formatted": "+90 322 351 24 50",
      "city": "Adana",
      "district": "Seyhan",
      "address": "Kurtuluş Mah. Atatürk Cad. No:23 Seyhan/ADANA",
      "is_sentry": false,
      "coordinates": {
        "lat": "36.986819",
        "lon": "35.340378"
      }
    }
  ],
  "pagination": {
    "total": 3128,
    "per_page": 50,
    "current_page": 1,
    "total_pages": 63,
    "has_more": true,
    "prev_page": null,
    "next_page": 2
  }
}

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
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

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('API_BASE_URL/notaries/all-sentry-notaries/2025-07-06/1', {
  headers: {
    'X-Api-Key': 'API_KEY_ANAHTARINIZ'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Hata:', error);
});

// İl bazlı nöbetçi noterleri listeleme
axios.get('API_BASE_URL/notaries/sentry-city-notaries/2025-07-06/istanbul', {
  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ç