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を開き、再生をE2Eで検証します。トークンやメディア設定なしでEpisode 009 Confessionの9:16プレビューをすぐ再生します。 - イベント検証規約はProductionと同じです。金融精算APIにはProductionキーが必要なため、Sandboxでは取り込み結果までを検証します。
分離
SandboxとProductionはベースURLを共有しますが、キーとデータコンテキストは別です。各キーのプレフィックスに環境が1つエンコードされ、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チェックリストに従います。