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 数据

  1. 使用所需作用域创建 nsp_test_ 密钥(API 密钥)。
  2. 使用 GET /catalog/titles 列出 Sandbox 作品,再通过 /titles/{id}/episodes 查看 ID。
  3. 按照 快速开始 签发令牌、播放 HLS 并发送事件。

限制与差异

项目SandboxProduction
播放是否需要授权协议否(仍需可见权利包)是(ACTIVE 协议)
数据模拟 / isSandbox真实
结算无法访问金融结算 API查看并质疑真实结算单
速率限制每密钥默认 60/min每密钥默认 60/min

请根据文档和 OpenAPI 示例验证结算响应结构;真实结算单只能使用 Production 密钥获取。准备上线后,请遵循 Production 检查清单。