샌드박스 가이드

체결된 라이선스나 실제 비용 없이 전체 연동을 구축하고 테스트할 수 있습니다. 기본 URL: https://signal-partners.newunivers.ai/v1; 키 접두사는 nsp_test_입니다.

샌드박스가 제공하는 것

• Production과 동일한 카탈로그 API로 탐색할 수 있는 isSandbox 타이틀 및 에피소드의 더미 카탈로그입니다.
• 라이선스 계약 없이 재생할 수 있습니다. Sandbox POST /playback/tokens는 ACTIVE 계약 없이도 호스팅된 webview_url과 동등한 서명 매니페스트를 반환합니다. 파트너에게 노출되는 권리 패키지는 여전히 필요하며 country가 있으면 권리 지역과 대조합니다. 비PII preferences로 개인화를 시험하세요. 재생 API를 참고하세요.
• 테스트 웹뷰: WebView 또는 iframe에서 https://signal-partners.newunivers.ai/w/test?subtitle=ko&audio=ko&lang=ko&autoplay=1을 열어 재생을 종단 간 검증하세요. 토큰이나 미디어 설정 없이 Episode 009 Confession 9:16 프리뷰를 즉시 재생합니다.
• 이벤트 검증 규약은 Production과 같습니다. 금융 정산 API는 Production 키 전용이므로 Sandbox에서는 수집 결과까지만 검증합니다.

격리

Sandbox와 Production은 기본 URL을 공유하지만 별도의 키와 데이터 컨텍스트를 사용합니다. 각 키 접두사에는 하나의 환경이 인코딩되며 titles.isSandbox 및 세션·로그의 환경이 모든 요청을 해당 카탈로그로 한정합니다. nsp_test_는 Sandbox, nsp_live_는 Production을 선택합니다.

샌드박스 데이터 가져오기

1. 필요한 스코프로 nsp_test_ 키를 생성하세요(API 키).
2. GET /catalog/titles로 Sandbox 타이틀을 조회한 뒤 /titles/{id}/episodes에서 ID를 확인하세요.
3. 빠른 시작에서와 같이 토큰을 발급하고 HLS를 재생하며 이벤트를 전송하세요.

한도 및 차이점

정산 응답 구조는 문서와 OpenAPI 예제로 검증하고 실제 정산서는 Production 키로만 조회하세요. 출시 준비가 되면 프로덕션 체크리스트를 따르세요.