変更履歴

NU Signal Partners APIの重要な変更です。バージョンはパスに固定され（/v1）、各項目はopenapi/partner-api.yamlの改訂を追跡します。

0.6.0

• 安全な申請claim — 新規申請は参照と一度だけ表示される状態トークンを返します。承認後、パートナーは72時間のbootstrapトークンをアトミックに一度claimします。公開申請には明示的なプライバシー同意が必要です。
• 商取引条件の契約軸 — 使用種別、MG/RS、定額、API・データライセンス料金、範囲、契約スナップショットをdealに固定し、精算が直接利用します。
• 読み取り専用Partner Portal — 生のAPIキーを保存しない署名セッションで、カタログ、deal、Production精算を参照します。
• 環境分離を強化 — 金融精算APIはProductionキー専用で、Sandbox呼び出しはproduction_key_requiredを返します。

0.5.0

• 型安全なJS/TS SDK — packages/sdk-jsが公開申請と初回キーブートストラップを含む全Partner APIルートに具体的なリクエスト・レスポンス型を提供します。parityテストが欠落・古いメソッドを防ぎます。
• 正確なOpenAPIレスポンス契約 — 成功・エラーエンベロープとrequired/nullable定義が実レスポンスに一致し、契約・精算詳細にupdated_atウォーターマークを一貫して提供します。
• セッション失効の整合性 — アクティブセッションはrevoked、終了済みは実際の最終状態を返します。allowed_ipsはトークン発行だけに適用され、視聴者のメディアIPには適用されません。
• 返金符号の正規化 — REFUND.revenue_amountは台帳で常に負数に正規化され、精算純売上から一貫して差し引かれます。

0.4.0

• ホスト型WebView再生 — POST /playback/tokensがmanifestとともにホスト型webview_urlを返します。プレイヤー統合なしでWebViewまたはiframeで開け、両方が1つのセッションに紐づきます（再生API）。
• 視聴者設定 — 任意の非PII preferencesがWebViewをパーソナライズし、セッションに保存されます（GET /playback/sessions/{id}で返却）。スキーマは厳格で、@または空白を含む値はvalidation_failed（422）で拒否されます。
• 公開申請の重複排除 — 同じ連絡先メールで24時間以内にPOST /partner-applicationsを再送すると、新しい行を作らず既存申請を200とdeduped: trueで返します。

0.3.0

• 整合性ガードを強化 — 既知のPrismaエラーを明確な4xxへマッピング: P2002 → conflict（409）、P2003 → validation_failed、P2025 → resource_not_found（エラーコード）。
• リクエストサイズ上限 — イベントpayloadは4KBに制限され、文字列フィールドには明示的な長さ制限があります。
• 公開ルートのレート制限 — 未認証のPOST /partner-applicationsとPOST /v1/api-keys/bootstrapはクライアントIPごとに20/minです。
• 冪等性競合 — 処理中のX-NU-Request-Idで再生トークンまたはライセンスリクエスト作成を再試行すると、重複書き込みではなくconflict（409）を返します。完了済みは元のレスポンスを再生します。

0.2.0

• 標準エラーエンベロープ — すべてのエラーが固定コードセットと{ "error": { code, message, request_id, details? } }を返します（エラーコード）。
• リクエストヘッダー — Authorization、X-NU-Partner-Id、任意のX-NU-Request-Idを正式化しました（認証）。
• イベント分類 — 精算適格性を導出する標準EventType値です（イベントAPI）。
• 精算の異議と調整 — POST /settlements/{id}/disputeと拡張された精算手数料・分配フィールド（精算API）。
• カーソルページネーション — 一覧エンドポイントがcursorを受け取り、page/limitとともにnext_cursorを返します（カタログAPI）。

0.1.0 — 初期Sandbox API

初期MVPスキャフォールド: 分離されたSandbox環境向けのカタログ、ライセンス、再生、イベントAPI。