Media Connect Center 개요

Prev Next

Media Connect Center는 네이버 클라우드 플랫폼의 다양한 미디어 서비스 및 Object Storage와 결합하여 미디어 파일 관리를 위한 그룹화에서부터 인코딩, CDN 연동, 채널 생성, 배포까지 미디어 서비스 전체를 한 화면에서 통합 관리하고 운영하도록 돕는 네이버 클라우드 플랫폼의 서비스입니다. Media Connect Center 서비스에서는 조직, 구성원, 직급, 직책 등을 조회 및 설정할 수 있는 API를 RESTful 형태로 제공합니다.

Media Connect Center 공통 설정

Media Connect Center API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://ncloudmcc.apigw.fin-ntruss.com

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
  • Unix Timestamp 형식
x-ncp-iam-access-key Required 네이버 클라우드 플랫폼에서 발급받은 Access Key
x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
Content-Type Required 요청 데이터의 형식
  • application/json
x-ncp-region_code Optional 리전 코드
  • KR: 한국 (유효 값)

응답

공통 응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

error

error는 API 호출 실패 정보를 정의합니다. error에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
error Object - 오류 코드 및 메시지
error.errorCode String Required 오류 코드
error.message String Required 오류 메시지

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

코드 메시지 설명
180000 Company does not exist 회사를 찾을 수 없음
180001 Forbidden, please check the sync setting in console 접근 금지, 콘솔의 동기화 설정 확인 필요
180002 The service version does not support this function 서비스 버전이 해당 기능을 지원하지 않음
180003 Unauthorized 인증 실패
180004 Upper dept external key not found 상위 부서 외부 키를 찾을 수 없음
180006 Upper externalKey can not be the current dept externalKey 상위 부서의 외부 키가 현재 부서의 외부 키가 될 수 없음
180007 Department not found 부서를 찾을 수 없음
180008 Root dept can not be updated 최상위 부서는 수정할 수 없음
180009 Upper dept can not be the current dept's sub dept 상위 부서가 현재 부서의 하위 부서가 될 수 없음
180010 Root dept can not be deleted 최상위 부서는 삭제할 수 없음
180011 External key exists 외부 키가 이미 존재함
180012 Name exists 이름이 이미 존재함
180013 Job grade not found 직급을 찾을 수 없음
180015 Job position not found 직책을 찾을 수 없음
180016 Service version only can create {0} users 서비스 버전에서 {0}명의 사용자만 생성 가능
180017 User login ID already exist 사용자 로그인 아이디가 이미 존재함
180018 Bad request 잘못된 요청
180019 User not found 사용자를 찾을 수 없음
180020 The user does not belong to this company 사용자가 해당 회사에 속하지 않음
180021 Delete Admin not allowed 관리자 삭제가 허용되지 않음
180022 Method not allowed 허용되지 않는 메서드
180023 Unsupported media type 지원하지 않는 미디어 타입
180024 Internal server error 내부 서버 오류
181001 Name is required 이름이 필요함
181002 Name format error 이름 형식 오류
181003 External key format error 외부 키 형식 오류
181004 Tel number format error 전화번호 형식 오류
181005 Cell phone number format error 휴대전화번호 형식 오류
181006 Locale type format error 로케일 타입 형식 오류
181007 Time zone format error 타임존 형식 오류
181008 User email address is required 사용자 이메일 주소가 필요함
181009 User email address format error 사용자 이메일 주소 형식 오류
181010 Display order is required 표시 순서가 필요함
181011 Display order format error 표시 순서 형식 오류
참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

응답 예시

호출이 성공한 경우의 응답 예시는 각 API 명세에서 확인해 주십시오. 호출이 실패한 경우의 응답 예시는 다음과 같습니다.

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

Media Connect Center API

Media Connect Center 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

부서

부서 관련 API에 대한 설명은 다음과 같습니다.

API 설명
부서 생성 부서 생성
부서 목록 조회 부서 목록 조회
부서 조회 부서 상세 정보 조회
부서 수정 부서 정보 수정
부서 삭제 부서 삭제

직급

직급 관련 API에 대한 설명은 다음과 같습니다.

API 설명
직급 생성 직급 생성
직급 목록 조회 직급 목록 조회
직급 조회 직급 상세 정보 조회
직급 수정 직급 정보 수정
직급 삭제 직급 삭제

직책

직책 관련 API에 대한 설명은 다음과 같습니다.

API 설명
직책 생성 직책 생성
직책 목록 조회 직책 목록 조회
직책 조회 직책 상세 정보 조회
직책 수정 직책 정보 수정
직책 삭제 직책 삭제

구성원

구성원 관련 API에 대한 설명은 다음과 같습니다.

API 설명
구성원 생성 구성원 생성
구성원 목록 조회 구성원 목록 조회
구성원 조회 구성원 상세 정보 조회
구성원 수정 구성원 정보 수정
구성원 삭제 구성원 삭제

Media Connect Center 연관 리소스

Media Connect Center API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.