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 | 動画のサイズが制限を超えています。 |
このドキュメントの内容は役に立ちましたか?
はい
いいえ