{
 "openapi": "3.1.0",
 "info": {
  "title": "ShadeHop Park API",
  "version": "1.0.0",
  "description": "新北市林口區、臺北市遮陽/避雨公園、附近停車場與電動車充電站（快充/慢充）。靜態 JSON，每筆事實都附 method/verified_at/confidence/source。",
  "license": {
   "name": "ODbL-1.0",
   "url": "https://opendatacommons.org/licenses/odbl/1-0/"
  }
 },
 "servers": [
  {
   "url": "https://shadehop-park.pages.dev"
  }
 ],
 "paths": {
  "/api/parks.json": {
   "get": {
    "operationId": "listParks",
    "summary": "全部公園（完整資料）",
    "responses": {
     "200": {
      "description": "{meta, parks[]}",
      "content": {
       "application/json": {}
      }
     }
    }
   }
  },
  "/api/parks.geojson": {
   "get": {
    "operationId": "listParksGeoJSON",
    "summary": "全部公園（GeoJSON 摘要，含遮陰時刻表）",
    "responses": {
     "200": {
      "description": "FeatureCollection",
      "content": {
       "application/geo+json": {}
      }
     }
    }
   }
  },
  "/api/parks/{id}.json": {
   "get": {
    "operationId": "getPark",
    "summary": "單一公園完整資料",
    "parameters": [
     {
      "name": "id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "example": "lk-w123456"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Park",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "https://shadehop-park.pages.dev/schema/park.schema.json"
        }
       }
      }
     },
     "404": {
      "description": "Not found"
     }
    }
   }
  },
  "/api/regions/index.json": {
   "get": {
    "operationId": "listRegions",
    "summary": "地區清單（id、名稱、範圍、公園數）",
    "responses": {
     "200": {
      "description": "regions[]",
      "content": {
       "application/json": {}
      }
     }
    }
   }
  },
  "/api/regions/{region}.geojson": {
   "get": {
    "operationId": "listRegionParksGeoJSON",
    "summary": "單一地區的公園（GeoJSON 摘要）",
    "parameters": [
     {
      "name": "region",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "linkou",
        "taipei"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "FeatureCollection",
      "content": {
       "application/geo+json": {}
      }
     }
    }
   }
  },
  "/api/meta.json": {
   "get": {
    "operationId": "getMeta",
    "summary": "資料集版本、計數與模型假設",
    "responses": {
     "200": {
      "description": "meta",
      "content": {
       "application/json": {}
      }
     }
    }
   }
  }
 }
}