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-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クラウドプラットフォームの認証キーおよび 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.