개요

NU Signal Partners API는 승인된 B2B 파트너가 하나의 서버 사이드 연동으로 영상·인터랙티브 IP를 탐색하고, 라이선스하고, 재생하고, 측정하고, 정산할 수 있게 합니다.

카탈로그에서 권리가 정리된 콘텐츠를 확인하고, 계약을 생성하고, 수명이 짧은 재생 또는 Runtime 세션을 인가하고, 표준 이벤트를 전송하고, Production 정산서를 대사하세요.

기본 URL 및 환경

Sandbox와 Production은 같은 호스트를 공유합니다. API 키가 격리된 환경과 데이터 컨텍스트를 결정합니다. 자세한 내용은 샌드박스 가이드를 참고하세요.

규약

• 버전 관리 — API 버전은 경로에 고정됩니다(/v1).
• 인증 — 모든 보호 요청에 bearer API 키를 전송하세요. 자세한 내용은 인증을 참고하세요. 공개 온보딩과 POST /v1/api-keys/bootstrap에는 bearer 키를 사용하지 않습니다.
• 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": "요청 검증에 실패했습니다.",
    "request_id": "req_01HQ...",
    "details": [
      {
        "field": "territories",
        "issue": "zod_invalid_format",
        "message": "값의 형식이 올바르지 않습니다."
      }
    ]
  }
}

핵심 기능

첫 연동 전체 과정을 진행하려면 빠른 시작로 이동하세요.