Get Video Upload Token

最終更新日:2023-01-29 18:04:20

動画をアップロードするためには、まずURLと認証情報(トークン)を取得する必要があります。この API は、URL と認証情報を取得するのに役立ち、動画 ID も生成します。

リクエスト 説明

アイテム 説明
リクエスト方法 ポスト/取得
URL https://api.cloudv.haplat.net/vod/videoManage/getUploadToken
認証が必要 はい

このインターフェースは、OpenAPIを介して呼び出すことを推奨します。リクエストに成功すると、OpenAPIが自動的にコードスニペットを生成してくれます。

リクエストパラメータ

パラメータ タイプ 必須 説明
originFileName string はい 拡張子を含むビデオファイルの名前。例えば、「uploadtest.mp4」です。
fileId string いいえ ブレークポイントID、最大32文字の長さ。このパラメータは、ブレークポイント-レジューム アップロードに使用されます。また、ブレークポイント-レジュームのアップロードは、このパラメータを指定した後にのみ機能します。
domain string いいえ 動画の再生ドメイン。
workflowId string いいえ ワークフロー ID。ワークフローIDは、クラウドVoDコンソールの [設定] > [ワークフロー] > [ワークフローID ] で確認できます。
注:workflowIdには、パラメータcmd、waterMarkName、transCodeCombineName、subtitleIdが含まれます。
overwrite string いいえ 既存のファイルを上書きするかどうか。
0–いいえ
1–はい
categoryNames string いいえ 映像カテゴリは、親カテゴリと子カテゴリを一度に設定することができます。
例えば、
[{“childName”:“child-category1”,“parentName”:“parent-category1”},{" childName":“子カテゴリ2”,“parentName”:“親カテゴリ2”}]
waterMarkName string いいえ 透かし。アップロードに成功すると、自動的に動画に追加されます。
transCodeCombineName string いいえ トランスコードテンプレートの名前。指定した場合、動画は、アップロードに成功した後にトランスコードテンプレートでトランスコードされます。
subtitleId string いいえ 字幕ID。指定すると、映像に字幕が追加されます。

レスポンスパラメータ

一般的なレスポンスについては、一般的なレスポンスをご覧ください。

パラメータ タイプ 説明
fileKey string ドメイン名とトップスラッシュを含まない相対パスで、例えば「video/201704/245bbb46f2c1456ae076d2f131949999_1492507971/test.flv」のようにします。
uploadToken string トークン(認証情報)は、後のアップロードの認証に使用します。
uploadUrl string アップロードURLは、動画ファイルのアップロード先を指定します。 URLは後のアップロードで使用します。
videoId string ビデオファイルのID。アップロードの完了後、ビデオに関する関連情報のクエリに使用できます。
httpDnsServe string HTTP DNSサーバーのアドレス。

入力例

curl -X POST 
  https://api.cloudv.haplat.net/vod/videoManage/getUploadToken 
  -H 'content-type: application/x-www-form-urlencoded; charset=utf-8' 
  -H "Host: api.cloudv.haplat.net" 
  -H "Authorization: your token" 
  -H "X-WS-Timestamp: current timestamp" 
  -H "X-WS-AccessKey: your AccessKey ID" 
  -d 'originFileName=uploadtest.mp4'

出力例

{
    "code": 200,
    "data": {
        "speedDomainlUrl": "",
        "bucketName": "iven-test-cloudv",
        "uploadUrl": "https://upload.cloudv.haplat.net",
        "uploadToken": "7e7dae54118c45a6ffd213a*****",
        "fileKey": "video/20230129/aea31e8fa8b441eba82ae0d0d900cf3b/555555554o90q7np55560365422q21os_62363dfef1a8446db77f4931a179a676.mp4",
        "httpDnsServer": "",
        "videoId": "fb67d77901851000ca2d54b900000000"
    },
    "message": "Operation successfully"
}

エラーコード

以下のエラーコードは、動画アップロードトークンの取得リクエスト専用です。一般的なエラーについては、一般的な応答を参照してください。

エラーコード 説明
1500 ファイル名が40文字を超えています。
1604 ファイルの MD5 値を空にすることはできません。
1605 MD5ストリングが長すぎます。
1606 ビデオ名を空にすることはできません。
1607 ビデオソースエラー。
1608 パラメータ overwrite が0でも1でもありません。
1609 動画サイズには、負でない整数のみを指定してください。
1610 動画のサイズが制限を超えています。