개요

NU Signal Partners API는 NU 영상 IP의 라이선싱, 재생, 측정, 정산을 위한 B2B 서비스입니다. 파트너는 이를 서버 사이드로 연동하여 카탈로그를 조회하고, 라이선스 계약을 체결하고, 재생을 인가하고(호스팅된 웹뷰 링크 또는 서명된 매니페스트), 이벤트를 전송하고, 월별 정산을 대사합니다.

이 레퍼런스는 개발자를 위한 진입점입니다.

기본 URL

샌드박스와 프로덕션은 서로 다른 키, 데이터, 기본 URL로 분리되어 있습니다. 각 키는 자체 환경 정보를 담고 있으므로, 샌드박스 키는 샌드박스 기본 URL에, 프로덕션 키는 프로덕션에 사용하도록 되어 있습니다. 샌드박스 가이드를 참고하세요.

규약

• 버전 관리 — API 버전은 경로에 고정되어 있습니다(/v1).
• 인증 — 모든 요청에는 인증에 명시된 헤더가 필요합니다. 단, 두 개의 공개 엔드포인트 POST /partner-applications와 POST /v1/api-keys/bootstrap는 예외입니다(후자는 일회성 승인 토큰으로 보호됩니다).
• JSON — 요청 및 응답 본문은 application/json입니다.
• 타임스탬프 — RFC 3339 / ISO 8601 UTC(예: 2026-06-24T00:00:00Z).
• 지역 / 언어 — ISO 3166-1 alpha-2 및 ISO 639-1.
• 금액 — ISO 4217 currency와 함께 표기되는 소수 금액.

응답 봉투

성공 응답은 페이로드를 data로 감싸며, 선택적으로 pagination을 포함합니다:

{
  "data": { "...": "..." },
  "pagination": { "page": 1, "limit": 20, "total": 42, "has_next": true, "next_cursor": "eyJpZCI6..." }
}

오류는 하나의 봉투를 공유합니다(오류 코드 참고):

{
  "error": {
    "code": "validation_failed",
    "message": "territories must be ISO 3166-1 alpha-2",
    "request_id": "req_01HQ...",
    "details": [{ "field": "territories", "issue": "invalid_format" }]
  }
}

기능

API를 처음 사용하시나요? 퀵스타트로 시작하세요.