HENGYING·CINEPILOT · 产品线文档 08 / 09

开放平台(PL6 · 6E)

数据 OpenAPI · AK/SK 权限密钥 · 计量审计 · 沙箱 · 伙伴应用接入

产品定位

开放平台(路由 /openapi,PL6 6E 阶段)向集团内部分系统与授权伙伴开放标准化数据 API:以票房大盘、影片榜、区域大盘、实时预警、排片建议 5 个标准化接口复用六大模块数据契约;以 AK/SK 密钥体系(申请 → 审核 → 启用)管控权限,QPS 与日调用双限流,调用按价目计量(调用点)并全量审计留痕;文档、参数示例与免密钥沙箱齐备,支持伙伴一次接入演练。

功能清单

编号功能说明状态
OP-01标准化数据 API指标/排片/预警三类 5 个接口,复用既有数据契约已实现
OP-02API 目录与文档路径/方法/参数示例/响应示例/价目/沙箱标记已实现
OP-03AK/SK 权限密钥应用申请 → 审核(通过/驳回)→ 启用/禁用;密钥轮换(回显一次)已实现
OP-04限流与计量QPS 滑动窗口限流 + 日调用上限;调用点计量(计费口径)已实现
OP-05调用审计日志应用/路径/成功失败/延迟/消耗/错误/IP 全留痕已实现
OP-06沙箱调试免密钥演练(/sandbox 前缀),返回真实演示数据已实现
OP-07计量看板应用数/今日调用/成功率/调用点/目录数已实现

网关实现口径

鉴权

Header 携带 X-App-Key + X-App-Secret(密钥直连校验),或 X-App-Sign: sig:{HMAC-SHA256(appSecret, path)} 签名校验;未启用/已禁用应用返回 403,密钥错误返回 401。

限流

QPS 采用内存滑动窗口(按应用 key 计数,每秒重置),超限返回 429;日调用量以当日 open_api_log 计数校验,达上限返回 429。

数据网关端点

端点说明调用点
GET /api/open/v1/boxoffice/overview票房大盘(level/startDate/endDate)1.00
GET /api/open/v1/boxoffice/film-rank影片票房榜1.00
GET /api/open/v1/boxoffice/region-summary区域票房大盘1.00
GET /api/open/v1/warnings实时预警流1.00
GET /api/open/v1/scheduling/suggestions排片建议1.00
数据契约:网关取数直接复用 BoxOfficeService / SchedulingService,返回结构即内部业务契约,保证对外口径与平台一致;沙箱走演示租户(tenant 1)免鉴权。

数据表

open_app(伙伴应用:app_key 全局唯一、scopes 授权范围、rate_limit/daily_limit、call_count/cost_points 计量)、open_api_catalog(API 目录,全局共享)、open_api_log(调用审计日志)。