{
  "name": "chelaile-api",
  "version": "2.0.0",
  "description": "Read-only HTTP API for 车来了 (Chelaile) realtime bus, metro and transit data.",
  "docs": "docs/API.md",
  "endpoints": [
    {
      "method": "GET",
      "path": "/v1/health",
      "description": "Service liveness probe"
    },
    {
      "method": "GET",
      "path": "/v1/cities",
      "description": "Supported cities (static dataset or upstream)"
    },
    {
      "method": "GET",
      "path": "/v1/cities/config",
      "description": "City refresh interval / display config"
    },
    {
      "method": "GET",
      "path": "/v1/reverse-geocode",
      "description": "WGS-84 coordinates → Chinese address"
    },
    {
      "method": "GET",
      "path": "/v1/my-location",
      "description": "Approximate caller location from an IP"
    },
    {
      "method": "GET",
      "path": "/v1/search",
      "description": "Search lines, stops and POIs by keyword"
    },
    {
      "method": "GET",
      "path": "/v1/search/more",
      "description": "Paginated 'see more' for one search category"
    },
    {
      "method": "GET",
      "path": "/v1/stops/nearby",
      "description": "Nearby stops + realtime arrivals"
    },
    {
      "method": "GET",
      "path": "/v1/stops/detail",
      "description": "All lines + buses + metro for a stop"
    },
    {
      "method": "GET",
      "path": "/v1/lines/detail",
      "description": "Full line info: stops + live buses"
    },
    {
      "method": "GET",
      "path": "/v1/lines/route",
      "description": "Line polyline coordinates for maps"
    },
    {
      "method": "GET",
      "path": "/v1/lines/realtime",
      "description": "Realtime buses + ETA for (line, stop)"
    },
    {
      "method": "GET",
      "path": "/v1/lines/buses",
      "description": "Nearest approaching bus for a stop"
    },
    {
      "method": "GET",
      "path": "/v1/lines/timetable",
      "description": "Per-trip schedule (rarely available)"
    },
    {
      "method": "GET",
      "path": "/v1/lines/refresh",
      "description": "Batch refresh multiple (line, stop) pairs"
    },
    {
      "method": "GET",
      "path": "/v1/transit/plan",
      "description": "Bus + metro transit route planning"
    }
  ]
}