首页与路线相关接口

首页接口

获取首页数据

GET /api/v1/home/index

• 入参：location、user_id、platform、version
• 返回：首页聚合展示数据与用户未读信息

获取轮播图详情

GET /api/v1/home/banner/{id}

• 返回轮播图内容详情及点击/展示统计

路线列表接口

获取路线列表

GET /api/v1/routes/list

• 核心入参：page、size
• 支持条件：时间、体力、兴趣标签、排序、位置、用户ID
• 返回：总数、分页信息、路线列表、筛选摘要

获取筛选选项

GET /api/v1/routes/filter-options

• 返回时间、体力、兴趣标签、排序项配置

路线详情接口

获取路线详情

GET /api/v1/routes/{route_id}/detail

• 支持按需包含节点、地图、评论
• 返回：路线详情、节点、地图、用户状态

获取评论列表

GET /api/v1/routes/{route_id}/comments

• 支持分页与按时间/点赞排序

提交评论

POST /api/v1/routes/{route_id}/comments

• 请求类型：multipart/form-data
• 支持内容、评分、图片、游览日期、实际时长
• 图片上限：9 张

路线收藏

POST /api/v1/routes/{route_id}/collect

• 参数：action=add/remove
• 返回最新收藏状态与收藏数

设计建议

• 首页接口适合做聚合查询与缓存优化
• 列表接口应支持防抖和分页幂等处理
• 评论与收藏接口需接入登录鉴权