Media Connect Center 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

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

공통설정

Media Connect Center API URL

https://ncloudmcc.apigw.ntruss.co/ncloudmcc/v1

요청 헤더

항목 필수 여부 설명
x-ncp-apigw-timestamp Y 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key Y 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2 Y Access Key ID 값과 Secret Key로 암호화한 서명
x-ncp-apigw-signature-v2:{API Gateway Signature}
x-ncp-region_code N 리전 코드 (KR)
x-ncp-region_code:KR
Content-Type Y 요청 Body Content Type을 application/json으로 지정
Content-Type: application/json

인증 헤더

Media Connect Center API를 사용하기 위해서는 API Gateway 인증이 필요합니다. 상세한 API Gateway 인증 관련 가이드는 NAVER Cloud Platform API를 참고해 주십시오.

Media Connect Center API 요청 구성

Header
  x-ncp-apigw-timestamp:{Timestamp}
  x-ncp-iam-access-key:{Sub Account Access Key}
  x-ncp-apigw-signature-v2:{API Gateway Signature}
  Content-Type:application/json
Body
  Json Object
URL
  {API_URL}/{resource}

Media Connect Center API 요청 예시

curl -i -s -X POST \
-H "Content-Type:application/json" \
-H "x-ncp-iam-access-key:HrR0s91elfiXEeTSZdwj" \
-H "x-ncp-apigw-timestamp:1700201285710" \
-H "x-ncp-apigw-signature-v2:GOWtfeX5Su8r8uvCyHfgb9RGCu0CwQP//eexqzhZTc4=" \
"https://ncloudmcc.apigw.ntruss.com/ncloudmcc/v1/companies/{CompanyID}/depts/dept019" \
-d "{\"name\": \"sales\", \"sortOrd\":0}"

공통 오류

Media Connect Center API의 오류는 HTTP 상태 코드와 응답의 Body내 오류 메시지를 통해 상세정보를 제공합니다.

HTTP 상태 코드

HTTP 상태 코드 응답 메시지 설명
200 OK 성공, 응답 데이터가 있을 경우
201 Create 생성 성공, 응답 데이터가 없을 경우
204 No Content 성공, 응답 데이터가 없을 경우
400 Bad Request 잘못된 요청일 경우
401 Unauthorized 인증 실패
403 Forbidden 권한 없음
404 Not Found 잘못된 URL이거나 대상 리소스를 찾을 수 없는 경우
500 Internal Server Error 그외 정의되지 않은 에러

오류 메시지 포맷

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