본문으로 건너뛰기

미디어 콘텐츠 키 관리

미디어 콘텐츠 키 관리 API v3 레퍼런스 바로가기
버전별 기능 범위 안내
  • 콘텐츠 키 정보 조회 및 할당: v2 및 v3에서만 지원합니다.
  • 콘텐츠 키 유효성 검사: v1 및 v3에서만 지원합니다.
  • 콘텐츠 키 교체: v1 및 v2에서만 지원합니다.
  • 공통 인증: 모든 버전의 API는 쿼리 스트링 파라미터(?access_token=)를 통한 공통 인증 방식을 사용합니다. 에러 판정 기준에 대한 공통 명세는 API v3 마이그레이션 가이드의 핵심 변경 사항 섹션을 참고하세요.

미디어 콘텐츠 키 정보 조회​

  • 기존 (v2): GET /vod/media-content-keys/{media_content_key}
  • 변경 (v3): GET /media-content-keys/{media_content_key}
변경 사항
  • v1 미지원: 해당 엔드포인트는 v1에서 지원하지 않습니다.
  • 응답 필드명 변경: 기존 v2의 key 필드가 v3에서 media_content_key로 변경되었습니다.
  • 응답 구조 단순화: 기존 v2에서는 media_content 및 media_channel 전체 데이터를 계층형 구조로 중첩하여 반환했으나, v3에서는 대역폭 최소화를 위해 upload_file_key 및 channel_key를 비롯한 1차원 평면 데이터 필드 구조로 반환합니다.
응답 구조 상세

응답 구조 대조​

  • v2
{
  "data": {
    "id": 12,
    "key": "string",
    "media_content": {
      "id": 34,
      "upload_file_key": "string",
      "title": "string"
    },
    "media_channel": {
      "id": 56,
      "channel_key": "string",
      "name": "string"
    }
  }
}
  • v3
{
  "data": {
    "id": 12,
    "media_content_key": "string",
    "upload_file_key": "string",
    "channel_key": "string",
    "status": true,
    "created_at": "string",
    "updated_at": "string"
  }
}

미디어 콘텐츠 키 유효성 검사​

  • 기존 (v1): POST /media/media_content_key/validate
  • 변경 (v3): GET /media-content-keys/validate
변경 사항
  • HTTP 메서드 전환: HTTP 메서드가 POST에서 GET으로 변경되었습니다.
  • 파라미터 전송 규격 전환: 기존 v1에서는 요청 본문에 콤마(,) 구분 텍스트 구조로 전달했으나, v3에서는 쿼리 스트링 배열 구조(media_content_keys[]=A&media_content_keys[]=B) 형태로 요청을 기입해야 합니다.
요청 파라미터 전송 규격 및 응답 구조 상세

요청 파라미터 전송 규격 대조​

구분v1 명세v3 명세
전송 영역요청 본문쿼리 스트링
파라미터명media_content_keysmedia_content_keys[]
값 구조String (예: "mck_key_A,mck_key_B")Array (예: media_content_keys[]=mck_key_A&media_content_keys[]=mck_key_B)

응답 구조 대조​

요청한 키 자체가 응답 데이터 필드명으로 선언되는 동적 데이터 확장 패턴은 동일하게 유지됩니다.

  • v1
{
  "error": 0,
  "result": {
    "mck_key_A": true,
    "mck_key_B": false
  }
}
  • v3
{
  "data": {
    "mck_key_A": true,
    "mck_key_B": false
  }
}

미디어 콘텐츠 키 할당​

  • 기존 (v2): PUT /vod/media-contents/{upload_file_key}/assign-media-content-key
  • 변경 (v3): PUT /media-contents/{upload_file_key}/media-content-keys/{media_content_key}/assign
변경 사항
  • v1 미지원: 해당 엔드포인트는 v1에서 지원하지 않습니다.
  • 파라미터 전송 경로 전환: 기존 v2에서는 콘텐츠 키(media_content_key) 항목을 요청 본문에 담아 전달했으나, v3 마이그레이션 가이드라인 규격에서는 대상 식별자가 모두 URL 경로(Path) 구조로 통합되었습니다.
  • 응답 데이터 포맷 고도화: v3는 규격화된 상태 코드를 포함한 데이터 구조를 반환합니다.
요청 파라미터 및 응답 구조 상세

요청 파라미터 구성 및 경로 대조​

구분v2 명세v3 명세
upload_file_keyURL 경로 파라미터URL 경로 파라미터 (앞부분 배치)
media_content_key요청 본문URL 경로 파라미터 (뒷부분 배치)

응답 구조 명세​

{
  "data": ApiVodMediaContent object,
  "status": "ok"
}

미디어 콘텐츠 키 상호 교체​

  • 기존 (v1): POST /media/channel/change_media_content_key/{media_content_key}
  • 기존 (v2): PUT /vod/media-content-keys/{media_content_key}/exchange-key
  • 변경 (v3): 미지원
API 공식 폐기 안내

v1 및 v2에서 제공되던 콘텐츠 키 교체 기능은 v3 명세에서 완전히 폐기되었습니다.