概要

NU Signal Partners APIは、承認済みB2Bパートナーが1つのサーバーサイド統合で動画・インタラクティブ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を使用します。
• 金額 — 金額は10進数とし、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": "値の形式が正しくありません。"
      }
    ]
  }
}

主要機能

最初の統合を一通り行うにはクイックスタートへ進んでください。