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

changelogs/2026-07/16_feat_grassland_guide_public_recommendations.md

@@ -0,0 +1,22 @@
+# 草原指南管理端免登录推荐接口
+
+- 工单：`wx/HL#5005`
+- 测试环境：已部署 `dev-v3`
+- 鉴权：不需要登录
+- 数据范围：源视频和推荐结果都必须是 `PUBLISHED`，推荐结果自动排除自身
+
+## 接口
+
+`GET /admin/grassland-guide/public/videos/{videoId}/recommendations`
+
+查询参数：
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| page | integer | 否 | 1 | 最小 1 |
+| pageSize | integer | 否 | 20 | 1～100 |
+
+`data` 为分页对象：`records`、`total`、`page`、`pageSize`；`records` 字段与列表接口一致。
+推荐继续使用后端推荐算法，相关性不足时随机兜底，不需要前端拼装。
+
+测试网关实测：HTTP 200，业务码 `200`。