Files
web_huakui_server/docs/App-H5接入.md
T
rootandClaude Opus 4.7 85c0071fd8 feat: 从黄果 NET hgdjnet-server 9bfbafe 导入 HKDJ 官网后端
来源:hgdjnet-server 9bfbafe10d417deea959bd53117bc88a10e60a83
项目身份 HKDJ / JHA-216,独立官网仓库,Jenkins 守卫键 hkdjnet
测试目录 /server/hkdj_net,App/Web API 30331/30332

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-10-16 11:20:04 +08:00

29 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 花魁 NET H5 接入
来源版本:黄果 NET `9bfbafe10d417deea959bd53117bc88a10e60a83`;花魁适配已推送开发分支并集成到独立test分支;本地构建、vet、配置/密钥隔离核验已通过,测试环境HTTP结果见交付记录。
H5 页面服务预留30334,目录 `/server/hkdj_net/h5`;H5 业务 API 为 `http://172.104.181.99:30331`。用户提供的测试页面域名为 `https://hkdjneth5.remoces.com`,域名代理待运维落地,不以域名已提供作为已部署页面的证明。
这里的“服务端渲染”指源黄果NET前端仓库 `ruisheng/jha-1021-91jhs/frontend/jha-1045-hgdjnet-web` 的Go页面程序读取模板并返回HTML。2026-10-10只读核验其Jenkins `Web_91YS_H5`:通过 `go build` 构建 `web_91ys_h5`,打包二进制、`static/`、`template/`,由Supervisor启动;源测试目录也存在对应静态资源和模板。因此H5需由前端交付独立Go页面程序及资源,不能套用HT的npm/dist上传脚本。
建议交接关系:H5测试域名的页面请求进入本项目30334页面服务;该页面服务/浏览器业务请求使用30331的App API。API服务和页面服务分别部署;源项目额外导航端口不在本次两前端入口规划内。
| 用途 | 方法 | 路径 |
| --- | --- | --- |
| 页面配置 | GET | `/api/app/config/info` |
| 短剧首页 | GET | `/api/app/playlet/home` |
| 短剧搜索 | GET | `/api/app/playlet/search` |
| 应用列表 | GET | `/api/app/applist/list` |
| 游客登录 | POST | `/api/app/auth/guest` |
| 依赖健康检查 | POST | `/api/app/health/ping` |
`/api/app/*` 路径及 NET 的 JSON 返回协议保留。页面路由仍使用源项目的 `/play/...`、`/topic-detail/...`、`/tags/...` 等路径;前端不应直接替换为现有花魁短剧 H5 的路由。
游客、账号和 token 属于独立花魁 NET 测试库;不能向黄果或现有花魁短剧接口发送本次联调请求。支付、购买和外部发布不做测试。播放所需的花魁媒资地址、密钥和资源记录尚未接入,不能沿用黄果资源。
后台前端30333和H5前端30334是两个独立服务入口。H5采用独立SSR进程时,直接监听30334,不额外复制黄果导航服务;本次只准备后端与端口规划,H5前端服务尚未部署。
测试已通过页面配置、首页、搜索、应用列表和游客登录(HTTP200、业务200);专用游客ID10001,设备标识 `codex_hkdjnet_guest_20261010`。这些结果不代表已有可播放内容。`/enkey/`、`/newenkey/` 缺少有效播放票据时返回业务6020;鉴权后的 `/lsjenkey` 因未配置密钥返回6020。无效H5播放票据按源逻辑走占位视频路径,当前媒资域名未配置,最终返回6020;不能将该结果当作真实播放已通过。健康检查拒绝其他项目标识,合法签名下Redis/MongoDB/ES均为ok。
前端交接还需配置品牌、域名、SSR监听和API转发,使用花魁NET的token与播放票据;广告、应用媒资、支付、短信及真实播放资源需使用花魁自己的接入资料。准确版本及核验明细见[测试交付记录](测试交付记录-20261010.md)。