rootandClaude Opus 4.7
85c0071fd8
来源：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>
3.1 KiB
花魁 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与播放票据；广告、应用媒资、支付、短信及真实播放资源需使用花魁自己的接入资料。准确版本及核验明细见测试交付记录。