Normal Upload

最終更新日:2023-01-29 17:42:32

はじめに

映像音声素材のURLとクレデンシャル(トークン)を取得した後、このAPIを呼び出して、映像、音声、素材をクラウドVoDにアップロードすることができます。

ファイルサイズが2GBを超える場合は、multpartアップロードを使用する必要があります。

リクエスト 説明

リクエスト方法 POST
URL <uploadUrl>/file/upload

uploadUrlはGet Upload Token APIから取得できます。

リクエストパラメータ

ヘッダ

パラメータ 必須 説明
Content-Type はい このAPIの場合、Content-Typeヘッダーは_multipart/form-data;boundary=xxxxxx_の形式である必要があります。
boundaryは、フォームによってランダムに生成された文字列です。自分で境界を指定する必要はありません。
Content-Length はい メッセージボディのサイズ (バイト単位)。

フォームデータ

パラメータ タイプ 必須 説明
token テキスト はい Get Upload Token APIから取得したトークン。
file ファイル はい ファイルのコンテンツ。

レスポンス

リクエストが成功した場合、レスポンスは次のように表示されます。

{“hash”:“<hash string>”,“response”:"{\“success\”:0}"}

応答のハッシュはURL安全なBase64文字列で、ファイルのハッシュ値を示します。
リクエストに失敗した場合、レスポンスは以下のようになります。

{ "code": "<error code>", "message": "<message>" }

入力例

curl -X POST \ https://upload.cloudv.haplat.net/file/upload \ -H 'cache-control: no-cache' \ -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \ -F file=@1b095d2c66034d6bb3d74fa4e306bf4c20171122162359.jpeg \ -F token=7e7dae54118c45a6ffd213a18c9d4847b51a73f1:M2Q4ODczNzU0YjY2NzQ1YTEwNzZmOGNlODQ3ZDZiOWE3MDk0NTlhNQ==:==

エラーコード

このAPI専用のエラーコードをいくつかリストします。エラーコードの詳細については、一般的なレスポンスをご覧ください。

エラーコードです ニュース
400 File Transmission Fail
401 Token Invalid
401 Token Format Invalid
401 Token Expired
401 Upload File Cannot be Empty
401 File Too Large
405 Token Required
500 Internal Server Error
579 Callback Failed