{
  "openapi": "3.1.0",
  "info": {
    "title": "Su Haritası Açık Veri API",
    "version": "1.0.0",
    "description": "Türkiye’nin su verisi, havzaları ve su mevzuatı — makine-okunur JSON uçları. Kimlik doğrulama gerekmez. Kaynak gösterilerek kullanılabilir.",
    "license": {
      "name": "Kaynak gösterilerek kullanım (CC BY 4.0 uyumlu)",
      "url": "https://suharitasi.com/gizlilik/"
    },
    "contact": {
      "name": "Su Haritası",
      "url": "https://suharitasi.com"
    }
  },
  "servers": [
    {
      "url": "https://suharitasi.com"
    }
  ],
  "paths": {
    "/veri/havzalar.json": {
      "get": {
        "summary": "Türkiye’nin 25 su havzası: yağış alanı, yüzey suyu potansiyeli, YAS beslenimi/rezervi.",
        "operationId": "veri_havzalar_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    },
    "/veri/iller.json": {
      "get": {
        "summary": "81 il → DSİ bölge müdürlüğü, havza(lar) ve su/kanalizasyon idaresi eşlemesi.",
        "operationId": "veri_iller_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    },
    "/veri/islemler.json": {
      "get": {
        "summary": "20 su işlemi → yetkili kurum, mevzuat dayanağı, başvuru kanalı.",
        "operationId": "veri_islemler_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    },
    "/veri/mevzuat.json": {
      "get": {
        "summary": "469 mevzuat maddesi (167, YAS Tüzüğü, Su Tahsisleri ve ilgili kanunlar) — resmî metin.",
        "operationId": "veri_mevzuat_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    },
    "/veri/emsal.json": {
      "get": {
        "summary": "Danıştay/Yargıtay su hukuku emsal kararları (künye + özet).",
        "operationId": "veri_emsal_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    },
    "/veri/sozluk.json": {
      "get": {
        "summary": "126 su hukuku/yönetimi terimi ve mevzuat kaynağı.",
        "operationId": "veri_sozluk_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    },
    "/veri/su-riski.json": {
      "get": {
        "summary": "İl/havza Su Riski Endeksi: puan, kategori, bileşenler, zaman serileri, su bütçesi.",
        "operationId": "veri_su-riski_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    },
    "/veri/mevzuat-surum.json": {
      "get": {
        "summary": "İzlenen mevzuatın madde bazlı SHA-256 anlık görüntüsü (değişiklik radarı).",
        "operationId": "veri_mevzuat-surum_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    },
    "/kisit.json": {
      "get": {
        "summary": "Resmî Gazete işletme sahası ve tahsise kapatma/kısıt kayıtları (il eşlemeli).",
        "operationId": "kisit_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    },
    "/arama.json": {
      "get": {
        "summary": "Site içi arama indeksi (tüm sayfaların başlık/açıklama kaydı).",
        "operationId": "arama_json",
        "responses": {
          "200": {
            "description": "Başarılı JSON yanıtı",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {}
}