{
    "status": "OK",
    "data": {
        "name": "Türkiye API",
        "version": "1.0.0",
        "description": "Türkiye'nin il, ilçe, mahalle, köy ve belde verilerini sunan REST API",
        "endpoints": [
            {
                "path": "\/api\/provinces",
                "method": "GET",
                "description": "Tüm illeri listeler"
            },
            {
                "path": "\/api\/provinces\/{id}",
                "method": "GET",
                "description": "Belirli bir ili ilçeleriyle birlikte getirir"
            },
            {
                "path": "\/api\/districts",
                "method": "GET",
                "description": "Tüm ilçeleri listeler",
                "params": {
                    "province": "İl ID'sine göre filtrele",
                    "limit": "Sayfa başına kayıt (pagination)",
                    "offset": "Başlangıç noktası (pagination)"
                }
            },
            {
                "path": "\/api\/districts\/{id}",
                "method": "GET",
                "description": "Belirli bir ilçeyi detaylarıyla getirir"
            },
            {
                "path": "\/api\/neighborhoods",
                "method": "GET",
                "description": "Mahalleleri listeler",
                "params": {
                    "province": "İl ID'sine göre filtrele",
                    "district": "İlçe ID'sine göre filtrele",
                    "limit": "Sayfa başına kayıt (default: 100)",
                    "offset": "Başlangıç noktası"
                }
            },
            {
                "path": "\/api\/neighborhoods\/{id}",
                "method": "GET",
                "description": "Belirli bir mahalleyi detaylarıyla getirir"
            },
            {
                "path": "\/api\/villages",
                "method": "GET",
                "description": "Köyleri listeler",
                "params": {
                    "province": "İl ID'sine göre filtrele",
                    "district": "İlçe ID'sine göre filtrele",
                    "limit": "Sayfa başına kayıt (default: 100)",
                    "offset": "Başlangıç noktası"
                }
            },
            {
                "path": "\/api\/villages\/{id}",
                "method": "GET",
                "description": "Belirli bir köyü detaylarıyla getirir"
            },
            {
                "path": "\/api\/towns",
                "method": "GET",
                "description": "Beldeleri listeler",
                "params": {
                    "province": "İl ID'sine göre filtrele",
                    "district": "İlçe ID'sine göre filtrele",
                    "limit": "Sayfa başına kayıt",
                    "offset": "Başlangıç noktası"
                }
            },
            {
                "path": "\/api\/towns\/{id}",
                "method": "GET",
                "description": "Belirli bir beldeyi detaylarıyla getirir"
            }
        ],
        "examples": {
            "Tüm iller": "\/api\/provinces",
            "İstanbul (ID: 34)": "\/api\/provinces\/34",
            "İstanbul ilçeleri": "\/api\/districts?province=34",
            "İstanbul mahalleleri": "\/api\/neighborhoods?province=34",
            "İstanbul köyleri": "\/api\/villages?province=34",
            "Kadıköy mahalleleri": "\/api\/neighborhoods?district=1431"
        }
    }
}