샌드박스 가이드

샌드박스에서는 체결된 라이선스나 실제 비용 없이 전체 통합을 구축하고 테스트할 수 있습니다. 베이스 URL: https://nu-signal-partners.vercel.app/v1, 키는 nsp_test_ 접두사를 가집니다.

샌드박스가 제공하는 것

• 프로덕션과 동일하게 카탈로그 API로 탐색할 수 있는 isSandbox 타이틀 및 에피소드의 더미 카탈로그.
• 라이선스 계약 없이 재생 — 샌드박스 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 프리뷰를 즉시 재생합니다.
• 동일한 이벤트 및 정산 API를 제공하므로 전체 플로우를 시험해볼 수 있습니다.

격리

샌드박스와 프로덕션은 별도의 키, 데이터, 베이스 URL을 사용합니다. 각 키는 (접두사에 인코딩된) 고유 환경을 가지며, 이는 titles.isSandbox와 세션 및 로그에 기록된 환경을 통해 모든 요청을 해당 환경의 카탈로그로 한정합니다.nsp_test_ 키는 샌드박스 베이스 URL로, nsp_live_ 키는 프로덕션으로 향하게 하세요.

샌드박스 데이터 가져오기

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

한도 & 차이점

샌드박스 정산 수치는 예시이며 실제 정산/지급에서 제외됩니다. 정식 운영을 시작할 준비가 되면 프로덕션 체크리스트를 따르세요.