目录 API

浏览对您组织可见的 NU 作品和剧集。需要 catalog:read。目录仅返回合作伙伴可见、且由与所请求地区和语言匹配的 clear 或 restricted 权利包支持的作品。

端点

方法	路径	用途
GET	`/catalog/titles`	列出可用作品，支持筛选和分页。
GET	`/catalog/titles/{title_id}`	作品详情及权利可用性。
GET	`/catalog/titles/{title_id}/episodes`	作品的剧集。

列出作品

筛选条件

查询参数	类型	说明
`genre`	string	按类型筛选
`territory`	string	ISO 3166-1 alpha-2
`language`	string	ISO 639-1
`format`	string	例如：series、film
`resale_allowed`	boolean	仅允许转售的作品
`exclusive_available`	boolean	仅可提供独家的作品
`page`	integer	默认 1，最小 1
`limit`	integer	默认 20，最大 100
`cursor`	string	不透明游标；提供时忽略 page

分页

两种模式共用 pagination 封装。简单分页使用 page/limit；对于大型结果集的稳定向前迭代，请跟随 next_cursor。提供 cursor 时忽略 page。

curl "https://signal-partners.newunivers.ai/v1/catalog/titles?territory=KR&genre=drama&limit=20" \
  -H "Authorization: Bearer nsp_live_xxx" \
  -H "X-NU-Partner-Id: org_acme"

{
  "data": [
    {
      "title_id": "ttl_abc",
      "slug": "signal-city",
      "title": "Signal City",
      "title_en": "Signal City",
      "format": "series",
      "genres": ["drama", "thriller"],
      "episode_count": 12,
      "avg_duration_sec": 3600,
      "available_territories": ["KR", "JP"],
      "available_languages": ["ko", "en"],
      "resale_allowed": true,
      "exclusive_available": false,
      "license_status": "available"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 87, "has_next": true, "next_cursor": "eyJpZCI6InR0bF9hYmMifQ" }
}

跟随游标：

curl "https://signal-partners.newunivers.ai/v1/catalog/titles?cursor=eyJpZCI6InR0bF9hYmMifQ&limit=20" \
  -H "Authorization: Bearer nsp_live_xxx" -H "X-NU-Partner-Id: org_acme"

作品详情

GET /catalog/titles/{title_id} 返回摘要字段以及 logline、synopsis、original_language 和 rights 对象。若作品对组织不可见，则返回 404 resource_not_found。

权利可用字段（rights）

字段	含义
`available_territories / available_languages`	可授权的地区和受众
`resale_allowed, exclusive_available`	商业选项
`rights_status`	clear 或 restricted
`risk_level`	权利风险指标，小写；例如 low 或 medium

{
  "data": {
    "title_id": "ttl_abc",
    "slug": "signal-city",
    "title": "Signal City",
    "title_en": "Signal City",
    "logline": "A detective decodes a city that talks back.",
    "synopsis": "...",
    "format": "series",
    "genres": ["drama", "thriller"],
    "episode_count": 12,
    "avg_duration_sec": 3600,
    "original_language": "ko",
    "rights": {
      "available_territories": ["KR", "JP"],
      "available_languages": ["ko", "en"],
      "resale_allowed": true,
      "exclusive_available": false,
      "rights_status": "clear",
      "risk_level": "low"
    }
  }
}

剧集

curl "https://signal-partners.newunivers.ai/v1/catalog/titles/ttl_abc/episodes" \
  -H "Authorization: Bearer nsp_live_xxx" -H "X-NU-Partner-Id: org_acme"

{
  "data": [
    { "episode_id": "ep_001", "episode_no": 1, "name": "Pilot", "duration_sec": 3480, "free_preview": true }
  ]
}

使用 title_id 和 episode_id 请求报价（授权 API）或播放令牌（播放 API）。