Hoş Geldiniz
UYARI
v1 sürümü için 20 Haziran 2026 tarihinde yayımlanan güncelleme, son veri seti düzeyindeki bilgi güncellemesidir. Bu güncellemede 14 belde, 75 mahalle ve 27 köy veri setine eklenmiş, mevcut yerleşim birimlerinin nüfus bilgileri ise 2023 verilerinden 2025 verilerine güncellenmiştir. Bu tarihten sonra v1 sürümü yeni yerleşim yeri, nüfus güncellemesi veya benzeri veri seti düzeyindeki bilgi güncellemeleri almayacaktır. Ayrıca v1 için yeni özellik geliştirmesi yapılmayacaktır. Yazım hataları, küçük düzeltmeler veya kritik olmayan hata giderimleri en azından 2026 sonuna kadar değerlendirilebilir. Ancak ilerleyen bir tarihten sonra v1 sürümü tamamen bakım dışı bırakılacak ve herhangi bir güncelleme almayacaktır.
İPUCU
v2 sürümü ile birlikte, v1 sürümünde bulunan tüm özellikler v2 sürümünde de mevcuttur. Ancak v2 sürümü, v1 sürümüne göre daha fazla özellik ve geliştirme sunmaktadır. Bu nedenle, yeni projelerinizde v2 sürümünü kullanmanız önerilir.
TurkiyeAPI, Türkiye'nin idari bölümleri (il, ilçe, mahalle ve köyler) hakkında demografik ve coğrafi veriler sağlayan kapsamlı bir REST API'dır.
Bu rehber, TurkiyeAPI'nin özelliklerini ve kullanımını detaylı şekilde açıklamaktadır.
Özellikler
- REST Prensipleri: Representational State Transfer (REST) mimarisi prensiplerine uygun olarak tasarlanmıştır
- Açık Kaynak: Kaynak kodu GitHub'da mevcuttur
- Kapsamlı Veri: İdari bölümler hakkında demografik ve coğrafi veriler sunar
- Veri İşleme: Filtreleme, sıralama ve sayfalama desteği sağlar
- API Araçları: Postman ve Swagger ile tam uyumludur
- Kolay Erişim: Kimlik doğrulama gerektirmez, herkes tarafından kullanılabilir
Yeni Dokümantasyon
VitePress ile yeniden tasarlanan dokümantasyon:
- Hem başarılı hem başarısız API çağrılarını detaylandırır
- Zengin örnek istekler sunar
- Kullanıcı deneyimini iyileştirir
Neden dokümantasyonun değiştirildiği, eski dokümantasyona ne olduğu gibi bilgilere ilgili SSS sayfasından erişebilirsiniz.
API Araçları
TurkiyeAPI, Postman ve Swagger gibi popüler API araçları ile uyumludur:
Kimlik Doğrulama
TurkiyeAPI, kimlik doğrulama gerektirmeyen bir API'dir ve herkes tarafından kullanılabilir. Kimlik doğrulama gerektirmeyen API'lar, kullanıcıların kimlik doğrulama yapmadan API'yi kullanmalarına olanak tanır. Bu, API'nin daha geniş bir kullanıcı kitlesine hitap etmesine ve daha kolay erişilebilir olmasına olanak tanır.
İletişim
TurkiyeAPI hakkında sorularınız veya geri bildirimleriniz varsa, lütfen GitHub sayfamızı ziyaret edin veya doğrudan mail gönderebilirsiniz.
Bağış
TurkiyeAPI tamamen ücretsiz, açık kaynak kodludur ve kâr amacı gütmemektedir. Yine de TurkiyeAPI'nin geliştirilmesine destek olmak için bağış yapabilirsiniz. Bağışlar, sunucu masraflarını karşılamak ve yeni özellikler eklemek için kullanılacaktır. Bağış yapmak için bu bağlantıyı ziyaret edebilirsiniz.
