본문으로 건너뛰기

미디어 인증 관리

미디어 인증 관리 API v3 레퍼런스 바로가기
버전별 기능 범위 안내
  • v2 미지원: 미디어 인증 기능은 v2에서 지원하지 않습니다.
  • 공통 인증: 모든 버전의 API는 쿼리 스트링 파라미터(?access_token=)를 통한 공통 인증 방식을 사용합니다. 에러 판정 기준에 대한 공통 명세는 API v3 마이그레이션 가이드의 핵심 변경 사항 섹션을 참고하세요.

Kollus 암호화 적용​

  • 기존 (v1): POST /media_auth/media_token/get_kollus_encrypt
  • 기존 (v2): 미지원
  • 변경 (v3): POST /media/kollus-encrypt
변경 사항
  • 요청 구조 유지: 요청 본문에 source_string(암호화 대상 문자열) 필드를 필수로 전달하는 규격은 v1과 동일합니다.
  • 응답 데이터 포맷 변경: v1에서는 암호화 결과값 뒤에 '|V1.0'이라는 접미사가 포함되어 반환되었으나(결과|V1.0), v3에서는 접미사가 제거된 순수한 암호화 문자열 데이터만 encoded 필드에 담아 반환합니다.
요청 본문 및 응답 구조 상세

요청 본문​

필드데이터 타입필수 여부설명
source_stringString필수암호화 대상 원본 문자열

응답 구조 대조​

  • v1
{
  "error": 0,
  "message": "success",
  "result": "A1B2C3D4E5|V1.0"
}
  • v3
{
  "data": {
    "encoded": "A1B2C3D4E5"
  },
  "status": "ok"
}

사용자 키 생성​

  • 기존 (v1): POST /media_auth/user_key/create
  • 기존 (v2): 미지원
  • 변경 (v3): POST /media/user-key
변경 사항
  • 인증 일원화: 서비스 계정 식별을 위해 사용되던 content_provider_key 필드가 제거되었습니다. v3부터는 access_token으로 서비스 계정 권한을 식별합니다.
  • 필수 파라미터: remote_addr 및 user_agent 필드가 v3부터 필수 파라미터로 변경되었습니다.
  • 유효 시간 커스텀: v1에서는 발급 후 유효 시간이 6시간으로 고정되었으나, v3에서는 user_key_timeout(sec) 필드를 통해 만료 시간을 직접 지정할 수 있습니다.
요청 본문 및 응답 구조 상세

요청 본문​

필드데이터 타입v1 필수 여부v3 필수 여부설명
client_user_idString / Integer필수 (Integer)필수 (String)고객사 사용자 ID
content_provider_keyString필수-서비스 계정 키 (access_token으로 대체)
remote_addrString선택필수접속 클라이언트 IP 주소
user_agentString선택필수접속 클라이언트 브라우저 환경
user_key_timeoutInteger-선택키 유효 시간 (sec)

응답 구조 대조​

  • v1
{
  "error": 0,
  "message": "success",
  "result": "key"
}
  • v3
{
  "data": {
    "user_key": "string"
  },
  "status": "ok"
}

사용자 키 재발급​

  • 기존 (v1): POST /media_auth/user_key/update (만료 연장 및 키 교체)
  • 기존 (v2): 미지원
  • 변경 (v3): PUT /media/user-key/{user_key} (재발급)
비즈니스 로직 변경

v3는 기존 사용자 키를 즉시 무효화(Invalidate)하고 새로운 키를 재발급하는 방식으로 동작합니다. 따라서 user_key가 동일하게 유지된다고 가정한 클라이언트 로직이 있는 경우, v3 전환 시 새 키로 교체되도록 수정해야 합니다.

응답 구조 상세

응답 구조 대조​

  • v1
{
  "error": 0,
  "message": "success",
  "result": "string"
}
  • v3
{
  "data": {
    "user_key": "string"
  },
  "status": "ok"
}

사용자 키 삭제​

  • 기존 (v1): POST /media_auth/user_key/delete (요청 본문 전송)
  • 기존 (v2): 미지원
  • 변경 (v3): DELETE /media/user-key/{user_key} (경로 파라미터 전송)
변경 사항
  • 메서드 및 전달 방식 변경: HTTP 메서드가 POST에서 DELETE로 변경되었습니다. 삭제할 대상인 user_key를 요청 본문이 아닌 경로 파라미터로 전달해야 합니다.
  • 인증 파라미터 제거: content_provider_key 필드가 제거되었습니다 (access_token으로 대체).

워터마킹 식별 코드 조회​

  • 기존 (v1/v2): 미지원
  • 변경 (v3): GET /media/watermarking-code
요청 파라미터 및 응답 구조 상세

요청 쿼리 파라미터​

파라미터데이터 타입필수 여부설명
client_user_idString필수고객사 사용자 ID

응답 구조 명세​

{
  "data": {
    "code": "string"
  }
}