Video Player Enhancement 개요
    • PDF

    Video Player Enhancement 개요

    • PDF

    Article Summary

    개요

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

    공통 설정

    Video Player Enhancement API URL

    https://vpe.apigw.ntruss.com/api/v1
    

    API Header

    항목필수 여부설명
    Content-TypeY요청 Body Content Type을 application/json으로 지정 (POST)
    x-ncp-apigw-timestampY1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것이다.
    API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
    x-ncp-iam-access-keyY포탈 또는 Sub Account에서 발급받은 Access Key ID
    x-ncp-apigw-signature-v2Y위 예제의 Body를 Access Key Id와 맵핑되는 SecretKey로 암호화한 서명
    HMAC 암호화 알고리즘은 HmacSHA256 사용
    x-ncp-region_codeN리전 코드 (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 상태 코드오류 코드오류 메시지설명
    200200Unauthorized서비스 신청이 되지 않은 상태
    400100when 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
    401200Authentication Failed인증 실패
    401210Permission Denied권한 없음
    404300Not Found Exception권한 없음
    429400Quota ExceededQuota 초과
    429410Throttle LimitedRate 초과
    429420Rate LimitedRate 초과
    413430Request Entity Too Large요청 엔티티 크기 초과
    503500Endpoint Error엔드포인트 연결 오류
    504510Endpoint Timeout엔드포인트 연결 시간 초과
    500900Unexpected Error예외 처리가 안된 오류

    공통 오류 코드 예시는 다음과 같습니다.

    • 요청 파라미터가 Content-type: application/json인 경우
      {
         "error":{
            "errorCode":"210",
            "message":"Permission Denied"
          }
       }
      

    NAVER Cloud Platform 인증키 및 Signature 생성 가이드 바로가기


    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.