v2.0 REST APINöbetçi Noter Dokümantasyonu

Sistem AktifJSON & HTTPS

Nöbetçi Noter Api

Nöbetçi Noter Api ile Türkiye genelindeki hafta sonu nöbetçi noter listelerine, il bazlı noter kayıtlarına ve koordinat bazlı en yakın noter konumlarına programatik erişim sağlayın.

Base URLHTTPS

API_BASE_URL

Yetkilendirme BaşlığıHeader

X-Api-Key: SENIN_API_ANAHTARIN

Ücretsiz Test API İste Endpoint'leri İncele

Genel Bakış & Giriş

Eczaneler.ORG Noter v2 REST API; Türkiye genelindeki hafta sonu nöbetçi noter listelerine, il bazlı noter kayıtlarına ve koordinat (enlem/boylam) bazlı en yakın noter lokasyonlarına programatik erişim sunan yüksek performanslı bir servistir.

RESTful & JSON

Standart HTTP fiilleri (GET, POST), temiz URL mimarisi ve tam tip uyumlu JSON çıktısı.

10 Dk Akıllı Önbellek

Önbellek mimarisi sayesinde milisaniyeler seviyesinde ultra hızlı yanıt süreleri.

IP & Anahtar Güvenliği

API Key doğrulaması ve dinamik IP Whitelist yönetim desteği ile tam güvenlik.

Diğer API Servisimiz: Nöbetçi eczane verilerine erişmek için nöbetçi eczane servisini de kullanabilirsiniz.

Eczane API Dokümanı

Kimlik Doğrulama (Authentication)

Tüm istekler güvenli HTTPS protokolü üzerinden gerçekleştirilmeli ve yetkilendirme için her istekteX-Api-Keybaşlığı (HTTP Header) eklenmelidir.

Örnek İstek Başlığı (HTTP Header)

X-Api-Key:SENIN_API_ANAHTARIN

Güvenlik Uyarısı: API anahtarınızı istemci tarafında (tarayıcı Javascript kodlarında) asla ifşa etmeyiniz. İsteklerinizi kendi sunucunuz üzerinden proxy ederek yönlendiriniz.

Sayfalama ve Limit Parametreleri (Pagination)

Tüm listeleme uç noktalarında esnek sayfalama desteklenir. URL path veya query string üzerinden sayfa numarası ve limit yönetilebilir:

VARSAYILAN LIMIT

25 Adet

Sayfa başına standart olarak dönen noter kaydı adedidir.

SAYFALAMA DESTEĞİ

/{page}

Örn: /all-sentry-notaries/2026-09-20/2 ile 2. sayfaya erişilir.

GÜNCEL TARİH FORMATI

YYYY-MM-DD

Nöbetçi noter sorgularında tarih 2026-09-20 formatında iletilir.

Dönen Pagination Meta Nesnesi

"pagination": {
  "total": 500,        // Toplam nöbetçi noter sayısı
  "per_page": "25",    // Sayfa başına dönen kayıt sayısı
  "current_page": "1", // Aktif sayfa numarası
  "total_pages": 42,   // Toplam sayfa sayısı
  "has_more": true,    // Sonraki sayfa var mı? (true / false)
  "prev_page": null,   // Önceki sayfa no
  "next_page": 2       // Sonraki sayfa no
}

Noter Veri Modeli (Şema Referansı)

API yanıtlarında dönen noter nesnesi aşağıdaki standart alanları barındırır:

Alan Adı	Veri Tipi	Açıklama & Standartlar
id	int	Noterliğin veritabanındaki benzersiz kimlik numarası (örn: `607`).
name	string	Noterliğin resmi tabela adı (örn: `"Sincan 7. Noterliği"`).
phone	string	Doğrudan arama formatında telefon numarası (örn: `"+903125120007"`).
phone_formatted	string	Boşluklu formatlanmış okunaklı telefon numarası (örn: `"+90 312 512 00 07"`).
city	string	İl adı (örn: `"Ankara"`).
city_id	int	İl plaka / ID kodu (örn: `6`).
district	string	İlçe adı (örn: `"Sincan"`).
district_id	int	İlçe kimlik kodu (örn: `620`).
address	string	Açık adres metni.
sentry_date	string	Nöbet tarihi (YYYY-MM-DD formatında, örn: `"2026-09-20"`).
sentry_date_format	string	Türkçe formatlanmış nöbet tarihi (örn: `"20 Eylül 2026"`).
note	string	Nöbet saatleri ve özel durum notları (örn: `"Cumartesi 09:00-16:00 / Pazar 10:00-14:00"`).
coordinates	object	Coğrafi koordinatlar: `lat` (enlem) ve `lon` (boylam).

Noter API Uç Noktaları (Endpoints)

Aşağıdaki tüm uç noktalara HTTPS üzerinden ve X-Api-Key başlığı ile istek gönderilebilir:

Nöbetçi Noter Servisleri

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

Tüm Nöbetçi Noterler

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

İstek Parametreleri

date

Tarih formatı YYYY-MM-DD (örn. 2025-07-06)

page

Sayfa numarası (varsayılan: 1)

Örnek Yanıt (JSON Response)200 OK

application/json

HTTP/1.1 200 OK

{
  "data": [
    {
      "id": 607,
      "name": "Sincan 7. Noterliği",
      "phone": "+903125120007",
      "phone_formatted": "+90 312 512 00 07",
      "city": "Ankara",
      "city_id": 6,
      "district": "Sincan",
      "district_id": 620,
      "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
  }
}

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

İl Bazlı Nöbetçi Noterler

Belirli bir ildeki nöbetçi noterleri listeler.

İstek Parametreleri

date

Tarih formatı YYYY-MM-DD (örn. 2025-07-06)

city

İl adı (örn. adana)

Örnek Yanıt (JSON Response)200 OK

application/json

HTTP/1.1 200 OK

[
  {
    "id": 506,
    "name": "Adana 6. Noterliği",
    "phone": "+903223213414",
    "phone_formatted": "+90 322 321 34 14",
    "city": "Adana",
    "city_id": 1,
    "district": "Yüreğir",
    "district_id": 115,
    "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"
    }
  }
]

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

İl Bazlı Noterler

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

İstek Parametreleri

city

İl adı (örn. adana)

page

Sayfa numarası (varsayılan: 1)

Örnek Yanıt (JSON Response)200 OK

application/json

HTTP/1.1 200 OK

{
  "data": [
    {
      "id": 522,
      "name": "Adana 22",
      "phone": "+903222473430",
      "phone_formatted": "+90 322 247 34 30",
      "city": "Adana",
      "city_id": 1,
      "district": "Çukurova",
      "district_id": 1757,
      "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
  }
}

POST/notaries/notaries-nearby

Koordinat Bazlı En Yakın Noterler

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

İstek Parametreleri

latfloatbodyZorunlu

Enlem (latitude) koordinatı (örn. 36.986819)

lonfloatbodyZorunlu

Boylam (longitude) koordinatı (örn. 35.340378)

is_sentryintegerbodyOpsiyonelVarsayılan: 1

Nöbetçi filtreleme seçeneği. Zorunlu değildir; gönderilmediğinde varsayılan olarak 1 kabul edilir.

Örnek İstek Gövdesi (JSON Request Body)

{
  "lat": 36.986819,
  "lon": 35.340378,
  "is_sentry": 1
}

Örnek Yanıt (JSON Response)200 OK

application/json

HTTP/1.1 200 OK

[
  {
    "id": 509,
    "name": "Adana 9. Noterliği",
    "phone": "+903224595353",
    "phone_formatted": "+90 322 459 53 53",
    "city": "Adana",
    "city_id": 1,
    "district": "Seyhan",
    "district_id": 110,
    "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"
    }
  },
  {
    "id": 507,
    "name": "Adana 7. Noterliği",
    "phone": "+903223513430",
    "phone_formatted": "+90 322 351 34 30",
    "city": "Adana",
    "city_id": 1,
    "district": "Seyhan",
    "district_id": 110,
    "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"
    }
  }
]

GET/notaries/cities

İller Listesi

Türkiye'deki tüm illeri listeler.

Örnek Yanıt (JSON Response)200 OK

application/json

HTTP/1.1 200 OK

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

GET/notaries/districts/{city}

İlçeler Listesi

Belirli bir ildeki tüm ilçeleri listeler.

İstek Parametreleri

city

İl adı (örn. adana)

Örnek Yanıt (JSON Response)200 OK

application/json

HTTP/1.1 200 OK

{
  "districts": [
    {
      "id": 110,
      "city_id": 1,
      "city_name": "Adana",
      "city_slug": "adana",
      "district_name": "Seyhan",
      "district_slug": "seyhan"
    }
  ]
}

GET/notaries/api-account-info

API Bilgileri

API hesabı hakkında bilgileri ve istatistikleri getirir.

Örnek Yanıt (JSON Response)200 OK

application/json

HTTP/1.1 200 OK

{
  "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 Servisi (Tüm Noterler)

PREMIUM SERVIS

GET/notaries/all-notaries/{page}

Tüm Noterler (Premium)

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.

İstek Parametreleri

page

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

Örnek Yanıt (JSON Response)200 OK

application/json

HTTP/1.1 200 OK

{
  "data": [
    {
      "id": 501,
      "name": "Adana 1. Noterliği",
      "phone": "+903223512450",
      "phone_formatted": "+90 322 351 24 50",
      "city": "Adana",
      "city_id": 1,
      "district": "Seyhan",
      "district_id": 110,
      "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
  }
}

Güvenlik & IP Yönetimi

POST/update-whitelist

IP Whitelist Ekleme ve Güncelleme

Kullanıcının API hesabına erişim izni olan IP adreslerini doğrudan günceller (mevcut olanın üzerine yazar). Hem Eczane hem de Noter API hesapları için ortak ve genel uç noktadır.

Önemli Uyarı:IP adresi güncelleme işlemi güvenlik gereği günde sadece 1 (bir) kez yapılabilir. Gün içinde tek bir IP değiştirme hakkınız bulunmaktadır.

İstek Parametreleri

ipsstring | string[]bodyZorunlu

Tanımlanacak IP adres(ler)i. Wildcard (yıldızlı) IP için en az 2 blok sayısal olmalıdır (örn: '5.132.*' veya '23.45.67.*', tek IP). Standart IP için en fazla 2 IP belirtilebilir (örn: ['192.168.1.1', '10.0.0.1']).

Örnek İstek Gövdesi (JSON Request Body)

{
  "ips": "5.132.*"
}

Örnek Yanıt (JSON Response)200 OK

application/json

HTTP/1.1 200 OK

{
  "status": true,
  "message": "IP whitelist başarıyla güncellendi.",
  "allowed_ip": "5.132.*",
  "ips": [
    "5.132.*"
  ],
  "total": 1
}

Entegrasyon Kod Örnekleri

Noter API servisini projenize entegre etmek için aşağıdaki hazır kod örneklerini doğrudan kopyalayabilirsiniz:

# 1. Tarih Bazlı Tüm Nöbetçi Noterleri Çekme (Sayfa 1)
curl --location 'API_BASE_URL/notaries/all-sentry-notaries/2026-09-20/1' \
  --header 'X-Api-Key: SENIN_API_ANAHTARIN'

# 2. Belirli Bir İldeki Nöbetçi Noterleri Çekme (Örn: İstanbul)
curl --location 'API_BASE_URL/notaries/sentry-city-notaries/2026-09-20/istanbul' \
  --header 'X-Api-Key: SENIN_API_ANAHTARIN'

# 3. İl Bazlı Tüm Noterleri Listeleme (Adana)
curl --location 'API_BASE_URL/notaries/city-notaries/adana/1' \
  --header 'X-Api-Key: SENIN_API_ANAHTARIN'

# 4. Konum Bazlı En Yakın Nöbetçi Noterler (POST)
curl --location 'API_BASE_URL/notaries/notaries-nearby' \
  --header 'X-Api-Key: SENIN_API_ANAHTARIN' \
  --header 'Content-Type: application/json' \
  --data '{
    "lat": 36.9868,
    "lon": 35.3403,
    "is_sentry": 1
  }'

# 5. İller Listesini Çekme
curl --location 'API_BASE_URL/notaries/cities' \
  --header 'X-Api-Key: SENIN_API_ANAHTARIN'

Örneklerdeki SENIN_API_ANAHTARIN alanını size iletilen anahtar ile değiştirin.bash

HTTP Yanıt ve Hata Kodları

API isteklerinde karşılaşabileceğiniz standart HTTP durum kodları ve anlamları:

Durum Kodu	Tanım	Açıklama & Olası Neden
200 OK	Başarılı	İstek başarıyla işlendi ve beklenen noter verisi JSON olarak döndürüldü.
400 Bad Request	Geçersiz İstek	Eksik parametre, geçersiz tarih formatı (YYYY-MM-DD harici) veya hatalı istek.
401 Unauthorized	Yetkisiz Erişim	`X-Api-Key` başlığı eksik veya gönderilen anahtar geçersiz.
403 Forbidden	Erişim Engellendi	Hesap süresi dolmuş, IP whitelist dışındaki adresten istek yapılmış veya yetkisiz endpoint.
404 Not Found	Kayıt Bulunamadı	Belirtilen tarihte veya ilde nöbetçi noter kaydı bulunamadı.
429 Rate Limit	Kota Aşımı	Tanımlı saatlik/dakikalık aşırı istek limiti aşıldı.
500 Server Error	Sunucu Hatası	Sunucu tarafında beklenmeyen bir hata oluştu. Telegram üzerinden destek alabilirsiniz.

Kullanım Kuralları ve Önbellek

Kullanım Limiti Yoktur (Sınırsız İstek):Noter API servisinde standart paketlerde istek sınırlaması bulunmaz. Adil kullanım (fair-use) kurallarına uyulduğu sürece dilediğiniz kadar istek yapabilirsiniz.

10 Dakikalık Önbellek (Cache): Nöbetçi noter verileri düzenli aralıklarla senkronize edilir. Yanıtları kendi uygulamanızda önbelleğe alarak performansı maksimize edebilirsiniz.
IP Whitelist Güvenliği: API istekleri yalnızca hesabınıza tanımlı izin verilen IP adreslerinden kabul edilir.
Dinamik IP Güncelleme: POST /update-whitelist uç noktası ile tanımlı IP adresinizi dilediğiniz zaman güncelleyebilirsiniz (Güvenlik gereği günde 1 kez IP değiştirme hakkı tanınmaktadır).
Güvenli Saklama: API anahtarınızı güvenli bir şekilde saklayınız ve üçüncü şahıslarla paylaşmayınız.

Paketler ve Fiyatlandırma

İhtiyacınıza uygun Noter API lisansına yıllık sabit ücretle sahip olabilirsiniz:

Tam Erişim

Nöbetçi Noter API

Türkiye genelindeki tüm nöbetçi noterlere ve il bazlı noter listelerine tam erişim.

₺750/ yıllık

Türkiye genelindeki tüm nöbetçi noterler
İl bazlı nöbetçi noter sorgulama
Koordinat bazlı en yakın noter sorgusu (Nearby)
Sınırsız API isteği ve sayfalama desteği
7/24 Teknik destek ve Postman koleksiyonu

Satın Al / Lisans Başlat

Özel Entegrasyon & Kurumsal

Yüksek trafikli platformlar, mobil uygulamalar veya sigorta/hukuk yazılımlarınız için özel SLA, dedicated cache veya özel sunucu çözümleri sunuyoruz.

Yüksek hacimli kurumsal API erişimi
Öncelikli SLA ve teknik danışmanlık
Faturalı ve kurumsal sözleşmeli satış

Kurumsal Teklif Al

Sıkça Sorulan Sorular (S.S.S.)

Noter API servisini ücretsiz test edebilir miyim?

Evet. Telegram üzerinden bizimle iletişime geçtiğinizde 3 günlük ücretsiz tam yetkili test API anahtarı tanımlanıp size iletilir.

Nöbetçi noterler hangi günlerde ve saatlerde çalışır?

Nöbetçi noterler genellikle hafta sonları (Cumartesi 09:00 - 16:00 ve Pazar 10:00 - 14:00 saatleri arasında) hizmet vermektedir. Güncel çalışma saatleri her kaydın note alanında döner.

IP adresim değişirse ne yapmalıyım?

API üzerinden POST /update-whitelist uç noktasını kullanarak veya Telegram destek hattımıza yazarak tanımlı IP adreslerinizi anında güncelleyebilirsiniz (Güvenlik gereği günde 1 kez IP değiştirme hakkı tanınmaktadır).

Nöbetçi olmayan standart noterlerin verisi de var mı?

Evet. İl bazlı tüm noter listesi endpoint'i ile veya Türkiye genelindeki tüm noterleri kapsayan Premium Noter servisi ile nöbetçi olmayan tüm noterlere de erişebilirsiniz.

İletişim & Teknik Destek

Telegram Doğrudan Destek & Başvuru

Noter API lisansı satın alma, 3 günlük ücretsiz test erişimi ve teknik entegrasyon sorularınız için Telegram üzerinden 7/24 bizimle doğrudan iletişime geçebilirsiniz.

Telegram'da Mesaj Gönder