wx/hl-api-changelog

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

2026-07-16 10:20:43 +08:00

850 B

原始文件 Blame 文件历史

草原指南管理端免登录播放接口

工单：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，真实素材返回播放地址与时长。