Sandbox 指南
无需已签署授权或真实费用即可构建并测试完整集成。基础 URL:https://signal-partners.newunivers.ai/v1;密钥使用 nsp_test_ 前缀。
Sandbox 提供的功能
- 可通过与 Production 相同的目录 API 浏览的
isSandbox作品和剧集模拟目录。 - 无需授权协议即可播放:Sandbox
POST /playback/tokens在没有 ACTIVE 协议时也会返回托管webview_url和等效签名清单。仍需合作伙伴可见的权利包;如提供country,会与其地区核对。可发送非 PII 的preferences测试个性化。参见 播放 API。 - 测试 WebView:在 WebView 或 iframe 中打开
https://signal-partners.newunivers.ai/w/test?subtitle=ko&audio=ko&lang=ko&autoplay=1,端到端验证播放。无需令牌或媒体配置即可立即播放Episode 009 Confession的 9:16 预览。 - 事件验证约定与 Production 相同。金融结算 API 需要 Production 密钥,因此 Sandbox 仅验证摄取结果。
隔离
Sandbox 与 Production 共用基础 URL,但使用独立密钥和数据上下文。每个密钥前缀编码唯一环境;titles.isSandbox 以及会话和日志中的环境将每次请求限制在对应目录。nsp_test_ 选择 Sandbox,nsp_live_ 选择 Production。
获取 Sandbox 数据
- 使用所需作用域创建
nsp_test_密钥(API 密钥)。 - 使用
GET /catalog/titles列出 Sandbox 作品,再通过/titles/{id}/episodes查看 ID。 - 按照 快速开始 签发令牌、播放 HLS 并发送事件。
限制与差异
| 项目 | Sandbox | Production |
|---|---|---|
| 播放是否需要授权协议 | 否(仍需可见权利包) | 是(ACTIVE 协议) |
| 数据 | 模拟 / isSandbox | 真实 |
| 结算 | 无法访问金融结算 API | 查看并质疑真实结算单 |
| 速率限制 | 每密钥默认 60/min | 每密钥默认 60/min |
请根据文档和 OpenAPI 示例验证结算响应结构;真实结算单只能使用 Production 密钥获取。准备上线后,请遵循 Production 检查清单。