Video Player Enhancement 개요

개요

Video Player Enhancement는 플레이어 코드를 가장 손쉽게 생성할 수 있는 통합 서비스입니다.
Video Player Enhancement를 통해 손쉽게 플레이어 코드를 생성한 후 원하는 곳에 붙여 넣어 간단히 영상 서비스를 구축할 수 있습니다.
또한 재생 통계가 자동으로 수집되므로 관련 시스템을 별도로 구축할 필요 없이 손쉽게 조회할 수 있습니다.

공통 설정

Video Player Enhancement API URL

https://vpe.apigw.gov-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 사용

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}
  Content-Type:application/json
Body
  Json Object
URL
  https://vpe.apigw.gov-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=" \
   "https://vpe.apigw.gov-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"
    }
 }