{
  "apis": [
    {
      "description": "7-day golf forecast. Accepts a 5-digit ZIP code or free-text city/state. Returns rated tee-time windows (Excellent/Good/Fair), course conditions, and sunrise/sunset bounds.",
      "example": "/v1/golf-weather?location=Cary%2C+NC",
      "method": "GET",
      "params": "?location=\u003cZIP or City, State\u003e",
      "path": "/v1/golf-weather"
    },
    {
      "description": "Global 7-day golf forecast. Accepts any lat/lon worldwide. Uses NWS for US coordinates, Open-Meteo elsewhere. Returns rated tee-time windows (Excellent/Good/Fair) and course conditions as structured JSON.",
      "example": "/v1/forecast?lat=35.6762\u0026lon=139.6503",
      "method": "GET",
      "params": "?lat=\u003cdecimal\u003e\u0026lon=\u003cdecimal\u003e",
      "path": "/v1/forecast"
    },
    {
      "description": "Climatological golf rating for any calendar date at any location. Based on 10 years of ERA5 reanalysis data. Returns rating distribution (Excellent/Good/Fair/Poor), typical temperature and wind ranges, and rain probability.",
      "example": "/v1/climate?lat=36.5686\u0026lon=-121.9498\u0026month=3\u0026day=15",
      "method": "GET",
      "params": "?lat=\u003cdecimal\u003e\u0026lon=\u003cdecimal\u003e\u0026month=\u003c1-12\u003e\u0026day=\u003c1-31\u003e",
      "path": "/v1/climate"
    },
    {
      "description": "Full-year climate heatmap data — all 365 calendar days rated. 10 concurrent ERA5 archive fetches server-side. Suitable for rendering a month×day heatmap. Cached 24h.",
      "example": "/v1/climate/year?lat=36.5686\u0026lon=-121.9498",
      "method": "GET",
      "params": "?lat=\u003cdecimal\u003e\u0026lon=\u003cdecimal\u003e",
      "path": "/v1/climate/year"
    },
    {
      "description": "Plain-text ASCII diagram of the system architecture and request flow.",
      "method": "GET",
      "params": "",
      "path": "/architecture"
    },
    {
      "description": "Liveness probe. Returns {\"status\":\"ok\"}.",
      "method": "GET",
      "params": "",
      "path": "/health"
    }
  ],
  "description": "Golf weather forecast API. Returns rated tee-time windows and course conditions for any location worldwide.",
  "service": "fairway-forecast",
  "version": "1.0"
}