Media Connect Center 개요
- 인쇄
- PDF
Media Connect Center 개요
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
개요
Media Connect Center는 네이버 클라우드 플랫폼의 다양한 미디어 서비스 및 Object Storage와 결합하여 미디어 파일 관리를 위한 그룹화에서부터 인코딩, CDN 연동, 채널 생성, 배포까지 미디어 버시스 전체를 한 화면에서 통합 관리하고 운영하도록 돕는 서비스입니다.
Media Connect Center는 조직/구성원/직급/직책 등을 조회 및 설정할 수 있는 API를 제공합니다. HTTP 방식의 GET/POST/PUT/DELETE 메서드 호출을 통해서 이루어집니다.
공통설정
Media Connect Center API URL
https://ncloudmcc.apigw.fin-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.fin-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"
}
}
이 문서가 도움이 되었습니까?