diff --git a/changelogs/2026-07/14_release_grassland_guide_production.md b/changelogs/2026-07/14_release_grassland_guide_production.md new file mode 100644 index 0000000..c99749f --- /dev/null +++ b/changelogs/2026-07/14_release_grassland_guide_production.md @@ -0,0 +1,41 @@ +# 草原指南接口已发布正式环境 + +- 日期: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 为准。