路线详情接口

概述

用于获取路线详情、景点规划、个人进度和徽章状态。

• 调用方：小程序前端
• 请求方式：GET
• 请求路径：/routes/{routeId}
• 请求头要求：可选登录态

请求参数

参数	类型	必填	说明
routeId	path string	是	路线 ID

返回参数

参数	类型	说明
route	object	路线信息
spots	array	景点规划列表
badgeStatus	string	徽章状态
progress	object	当前进度

成功示例

{"code":"0","message":"ok","data":{"route":{"routeId":"R001","routeName":"北线经典初游线"},"spots":[{"spotId":"S001"}],"badgeStatus":"unlockable","progress":{"checked":5,"total":5}}}

失败示例

错误码

错误码	说明
A0003	路线不存在或已下线

接口约束

项目	说明
幂等要求	否
前后端同步规则	打卡与徽章解锁后需强制回刷
缓存/刷新策略	缓存 1 分钟
一致性要求	关键状态强一致

说明

• 接口支持在可选登录态下访问。
• 涉及进度与徽章状态等关键用户状态时，需遵循强一致要求。
• 用户完成打卡或发生徽章解锁后，前端应立即触发强制刷新，避免展示旧状态。