---
outline: deep
---

# Hoş Geldiniz

**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](https://github.com/ubeydeozdmr/turkiye-api)'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](./faq.md) erişebilirsiniz.

## API Araçları

TurkiyeAPI, Postman ve Swagger gibi popüler API araçları ile uyumludur:

- [Postman Dokümantasyonu](https://documenter.getpostman.com/view/19561492/UzBguVHM)
- [Swagger UI](https://api.turkiyeapi.dev/swagger)

## 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](https://github.com/ubeydeozdmr/turkiye-api) sayfamızı ziyaret edin veya doğrudan [mail](mailto:ubeydeozdmr@gmail.com) 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ı](https://www.buymeacoffee.com/ubeydeozdmr) ziyaret edebilirsiniz.

<a href="https://www.buymeacoffee.com/ubeydeozdmr"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="buymeacoffee button" width="150" /></a>
