Video Player Enhancement 개요
- 인쇄
- PDF
Video Player Enhancement 개요
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
Video Player Enhancement는 플레이어 코드를 가장 손쉽게 생성할 수 있는 통합 서비스입니다.
Video Player Enhancement를 통해 손쉽게 플레이어 코드를 생성한 후 원하는 곳에 붙여 넣어 간단히 영상 서비스를 구축할 수 있습니다.
또한 재생 통계가 자동으로 수집되므로 관련 시스템을 별도로 구축할 필요 없이 손쉽게 조회할 수 있습니다.
공통 설정
Video Player Enhancement API URL
https://vpe.apigw.ntruss.com/api/v1
API Header
항목 | 필수 여부 | 설명 |
---|---|---|
Content-Type | Y | 요청 Body Content Type을 application/json으로 지정 (POST) |
x-ncp-apigw-timestamp | Y | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것이다. API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 |
x-ncp-iam-access-key | Y | 포탈 또는 Sub Account에서 발급받은 Access Key ID |
x-ncp-apigw-signature-v2 | Y | 위 예제의 Body를 Access Key Id와 맵핑되는 SecretKey로 암호화한 서명 HMAC 암호화 알고리즘은 HmacSHA256 사용 |
x-ncp-region_code | N | 리전 코드 (KR) |
Video Player Enhancement API 요청 구성
Header
x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2:{API Gateway Signature}
x-ncp-region_code:KR
Content-Type:application/json
Body
Json Object
URL
https://vpe.apigw.ntruss.com/api/v1/{action}
Video Player Enhancement API 요청 샘플
curl -i -s -X POST \
-H "Content-Type:application/json" \
-H "x-ncp-apigw-timestamp:1521787414578" \
-H "x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy" \
-H "x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=" \
-H "x-ncp-region_code:KR" \
"https://vpe.apigw.ntruss.com/api/v1/player"\
- d "{
"name": "api-guide",
"domains":
[
{"type" :"web", "domain":"http://*.naverncp.com"}
]
}"
Video Player Enhancement Content-Type
Video Player Enhancement API HTTP Request와 Response Body를 통해 전달되는 모든 데이터의 Content-type은 application/json
을 사용합니다.
성공
호출에 대한 응답 처리 방법은 플레이어 API 가이드의 응답 정보를 참고해 주십시오.
{
"code": "200",
"message": "OK",
"result": "{}"
}
실패
호출에 실패하여 리턴되는 오류 코드에는 서비스 공통 오류 코드와 서비스별 오류 코드가 있습니다. 서비스별 오류 코드는 각 서비스별 API 가이드의 오류 코드를 참고해 주십시오.
공통 오류 코드의 경우 JSON 형식이 기본값(default)입니다. 공통 오류 코드별 메시지와 설명은 다음과 같습니다.
HTTP 상태 코드 | 오류 코드 | 오류 메시지 | 설명 |
---|---|---|---|
200 | 200 | Unauthorized | 서비스 신청이 되지 않은 상태 |
400 | 100 | when page_no is too large, the error msg is page_no exceeds the size limit. when page_size is too large, the error msg is page_size exceeds the size limit. | Bad Request Exception |
401 | 200 | Authentication Failed | 인증 실패 |
401 | 210 | Permission Denied | 권한 없음 |
404 | 300 | Not Found Exception | 권한 없음 |
429 | 400 | Quota Exceeded | Quota 초과 |
429 | 410 | Throttle Limited | Rate 초과 |
429 | 420 | Rate Limited | Rate 초과 |
413 | 430 | Request Entity Too Large | 요청 엔티티 크기 초과 |
503 | 500 | Endpoint Error | 엔드포인트 연결 오류 |
504 | 510 | Endpoint Timeout | 엔드포인트 연결 시간 초과 |
500 | 900 | Unexpected Error | 예외 처리가 안된 오류 |
공통 오류 코드 예시는 다음과 같습니다.
- 요청 파라미터가
Content-type: application/json
인 경우{ "error":{ "errorCode":"210", "message":"Permission Denied" } }
NAVER Cloud Platform 인증키 및 Signature 생성 가이드 바로가기
이 문서가 도움이 되었습니까?