# 草原指南接口已发布正式环境

- 日期：2026-07-14
- 环境：正式环境
- 后端版本：`main@fb558bff`（初次发布 `27ae4612`，用户服务菜单修复 `fb558bff`）
- 管理后台版本：`hl-ui/master@4d305ca4`
- 关联工单：`wx/HL#4986`

## 正式地址

接口基址：`https://api.1814.love`

小程序接口：

- `GET /mp/grassland-guide/home`
- `GET /mp/grassland-guide/videos`
- `GET /mp/grassland-guide/videos/{videoId}`
- `GET /mp/grassland-guide/videos/{videoId}/recommendations`

管理端接口仍按此前草原指南 changelog 的 `/admin/grassland-guide/**` 契约调用。

正式管理后台 `https://admin.1814.love/grassland-guide` 已加载完整管理页面。若此前打开过“功能开发中”占位页，刷新页面即可重新拉取已修正的菜单路由；无需更换前端分支。

## 已验证行为

- 首页、分页列表允许匿名访问，正式网关返回 HTTP 200、业务成功。
- 分页参数由后端兜底：最小页码 1，每页最多 100 条。
- 管理端匿名请求返回业务 401，登录鉴权有效。
- 需要登录后查看的视频继续允许匿名浏览卡片；匿名用户不能取得受保护详情正文和播放地址。
- 视频地址为 OSS MP4 直出，不提供 VOD、CDN、HLS 或清晰度切换字段。
- 正式环境没有复制 TEST 的 50 条测试数据；当前空列表属于预期状态，前端应展示空态并正常支持后续运营上架。

## 契约文档索引

- `12_feat_grassland_guide_admin_mp_oss.md`
- `13_feat_grassland_guide_delete.md`
- `13_fix_grassland_guide_mp4_progressive_gate.md`
- `14_feat_grassland_guide_operation_logs.md`
- `14_fix_grassland_guide_operator_display_name.md`

本文件只告知正式环境可用状态，不新增或修改响应字段；字段与错误码仍以上述拆分 changelog 为准。