开放平台(路由 /openapi,PL6 6E 阶段)向集团内部分系统与授权伙伴开放标准化数据 API:以票房大盘、影片榜、区域大盘、实时预警、排片建议 5 个标准化接口复用六大模块数据契约;以 AK/SK 密钥体系(申请 → 审核 → 启用)管控权限,QPS 与日调用双限流,调用按价目计量(调用点)并全量审计留痕;文档、参数示例与免密钥沙箱齐备,支持伙伴一次接入演练。
| 编号 | 功能 | 说明 | 状态 |
|---|---|---|---|
| OP-01 | 标准化数据 API | 指标/排片/预警三类 5 个接口,复用既有数据契约 | 已实现 |
| OP-02 | API 目录与文档 | 路径/方法/参数示例/响应示例/价目/沙箱标记 | 已实现 |
| OP-03 | AK/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(调用审计日志)。