Appearance
景点详情接口
基本信息
- 接口名称：景点详情
- 接口用途：获取景点详情、图册、打卡状态
- 调用方：小程序前端
- 请求方式：
GET - 请求路径：
/spots/{spotId} - 请求头要求：可选登录态
- 幂等要求：否
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| spotId | path string | 是 | 景点 ID |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| spot | object | 景点信息 |
| checkinStatus | string | 打卡状态 |
| relatedRoutes | array | 关联路线 |
成功示例
{"code":"0","message":"ok","data":{"spot":{"spotId":"S001","spotName":"断桥残雪"},"checkinStatus":"uncheckin","relatedRoutes":[{"routeId":"R001"}]}}
失败示例
错误码
| 错误码 | 说明 |
|---|---|
| A0003 | 景点不存在或已下线 |
前后端约定
- 前后端同步规则：打卡成功后重新拉取
- 缓存/刷新策略：缓存 1 分钟
- 一致性要求：关键状态强一致
说明
该接口用于景点详情页的数据加载，返回景点基础信息、用户打卡状态以及关联路线信息。由于登录态为可选，前端可在游客态下获取景点基础内容；若涉及打卡状态展示，建议在登录态下调用并在打卡成功后立即重新拉取接口，以保证关键状态一致性。