İç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
/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
/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
/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
/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
/cities
Türkiye'deki tüm illeri listeler.
Örnek Yanıt:
{ "cities": [ { "name": "Adana", "slug": "adana" }, { "name": "İstanbul", "slug": "istanbul" } ] }
İlçeler Listesi
/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
/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
- 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.