最終更新日: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 |