查找附近健康站

提供基于坐标的附近健康站查询、全量列表分页浏览、以及健康站详情获取能力。所有接口均需用户 JWT 鉴权。

查找附近健康站

GET/api/v1/stations/nearby/list

基于用户当前坐标（WGS-84）返回指定半径内的健康站，按距离升序排列。

查询参数：

参数	类型	必填	说明
`lat`	number	是	用户纬度（WGS-84），如 `39.9042`
`lng`	number	是	用户经度（WGS-84），如 `116.4074`
`radius`	integer	否	搜索半径（米），默认 5000，最大 50000
`limit`	integer	否	返回数量，默认 10，最大 50

成功响应（200 OK）：

{
  "success": true,
  "code": 0,
  "data": [
    {
      "points_code": "STA001",
      "points_name": "晓葆健康站（朝阳门店）",
      "address": "北京市朝阳区朝阳门外大街 18 号",
      "lat": 39.9183,
      "lng": 116.4336,
      "distance_meters": 820,
      "business_hours": "09:00-18:00",
      "status": "active",
      "available_today": true,
      "cover_image": "https://cdn.xiaobaotop.com/stations/sta001.jpg"
    }
  ]
}

健康站列表

GET/api/v1/stations

分页浏览全部健康站，支持城市过滤和关键词搜索。

查询参数：

参数	类型	必填	说明
`page`	integer	否	页码，默认 1
`page_size`	integer	否	每页数量，默认 20，最大 50
`city_code`	string	否	城市编码（可从城市列表接口获取）
`keyword`	string	否	按健康站名称或地址搜索

健康站详情

GET/api/v1/stations/{pointsCode}

返回指定健康站的完整信息，包括设备列表、服务项目、评价统计、营业时间等。

路径参数：

参数	类型	说明
`pointsCode`	string	健康站唯一编码

城市列表

GET/api/v1/cities

返回有健康站覆盖的城市列表（按热门 + 字母分组），可用于城市选择器。

健康站对象说明

字段	类型	说明
`points_code`	string	健康站唯一编码，用于后续预约和到站接口
`points_name`	string	健康站名称
`address`	string	详细地址
`lat` / `lng`	number	经纬度（WGS-84）
`distance_meters`	integer	距用户位置的距离（米），仅附近查询返回
`business_hours`	string	营业时间文本，如 `"09:00-18:00"`
`status`	string	`active`（营业）/ `inactive`（暂停）
`available_today`	boolean	今日是否还有可预约时段

产品概述预约与管理