docs: 告知草原指南免登录只读接口 #5005

changelogs/2026-07/16_feat_grassland_guide_public_play.md

@@ -0,0 +1,25 @@
+# 草原指南管理端免登录播放接口
+
+- 工单：`wx/HL#5005`
+- 测试环境：已部署 `dev-v3`
+- 鉴权：不需要登录
+- 数据范围：只允许播放 `PUBLISHED`
+
+## 接口
+
+`GET /admin/grassland-guide/public/videos/{videoId}/play`
+
+`data` 字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| videoId | string | 视频业务 ID |
+| title | string | 标题 |
+| videoUrl | string | OSS MP4 直出地址 |
+| durationSeconds | integer | 素材自动解析的时长（秒） |
+| effectiveCoverUrl | string | 自定义封面或 OSS 自动截帧封面 |
+
+该接口是播放最小响应，不返回正文、创建人或操作信息。管理端免登录预览不受
+`loginRequired` 限制；小程序端仍按该字段执行登录鉴权。
+
+测试网关实测：HTTP 200，业务码 `200`，真实素材返回播放地址与时长。