Sandbox guide
Build and test the complete integration without an executed license or real charges. Base URL: https://signal-partners.newunivers.ai/v1; keys use the nsp_test_ prefix.
What Sandbox provides
- A dummy catalog of
isSandboxtitles and episodes, browsable through the same Catalog API as Production. - Playback without a license agreement: Sandbox
POST /playback/tokensreturns a hostedwebview_urland equivalent signed manifest without an ACTIVE agreement. A partner-visible rights package is still required, andcountry, when present, is checked against its territories. Send non-PIIpreferencesto test personalization. See Playback API. - A test webview: open
https://signal-partners.newunivers.ai/w/test?subtitle=ko&audio=ko&lang=ko&autoplay=1in a WebView or iframe to validate playback end to end. It immediately plays the 9:16Episode 009 Confessionpreview without a token or media setup. - The event validation contract matches Production. Financial settlement APIs require a Production key, so Sandbox validates only ingestion results.
Isolation
Sandbox and Production share a base URL but use separate keys and data contexts. Each key has one environment encoded in its prefix; titles.isSandbox plus the environment stored on sessions and logs confines every request to that catalog. nsp_test_ selects Sandbox and nsp_live_ selects Production.
Get Sandbox data
- Create a
nsp_test_key with the required scopes (API keys). - List Sandbox titles with
GET /catalog/titles, then inspect IDs through/titles/{id}/episodes. - Issue a token, play HLS, and send events as shown in Quickstart.
Limits and differences
| Item | Sandbox | Production |
|---|---|---|
| License agreement required for playback | No (a visible rights package is still required) | Yes (ACTIVE agreement) |
| Data | Dummy / isSandbox | Real |
| Settlements | No financial settlement API access | Read and dispute real statements |
| Rate limit | Default 60/min per key | Default 60/min per key |
Validate settlement response shapes against the docs and OpenAPI examples; retrieve real statements only with Production keys. When ready to launch, follow the Production checklist.