概览

NU Signal Partners API 让获批的 B2B 合作伙伴通过一套服务端集成来发现、授权、播放、衡量和结算视频与互动 IP。

使用目录查看权利已清理的内容、创建协议、授权短期播放或 Runtime 会话、发送规范事件，并核对 Production 结算单。

基础 URL 与环境

Sandbox 与 Production 共用同一主机。API 密钥决定相互隔离的环境和数据上下文。详情请参阅Sandbox 指南。

约定

• 版本控制 — API 版本固定在路径中（/v1）。
• 身份验证 — 每个受保护的请求都应发送 Bearer API 密钥。详情请参阅身份验证。公开注册流程和POST /v1/api-keys/bootstrap不使用 Bearer 密钥。
• JSON — 请求和响应正文使用 application/json。
• 时间戳 — 时间戳采用 RFC 3339 / ISO 8601 UTC 格式（例如 2026-06-24T00:00:00Z）。
• 地区和语言代码 — 地区代码使用 ISO 3166-1 alpha-2，语言代码使用 ISO 639-1。
• 金额 — 金额使用十进制数，并搭配 ISO 4217 currency 代码。

响应封装

成功响应将结果放在 data 中；列表端点还可能包含 pagination。

{
  "data": { "...": "..." },
  "pagination": { "page": 1, "limit": 20, "total": 42, "has_next": true, "next_cursor": "eyJpZCI6..." }
}

错误使用统一的封装格式和机器可读代码。详情请参阅错误代码。

{
  "error": {
    "code": "validation_failed",
    "message": "请求验证失败。",
    "request_id": "req_01HQ...",
    "details": [
      {
        "field": "territories",
        "issue": "zod_invalid_format",
        "message": "值的格式无效。"
      }
    ]
  }
}

核心功能

如需完成首次集成，请继续阅读快速开始。