file(ファイルアップロード) – millvi

ファイルキー

contents/create_videoやcontents/create_imageで、登録するファイルを指定するのに利用します。

ファイルタイプ

タイプ	内容
`video`	動画
`audio`	音声
`image`	画像
`pdf`	PDF
`other`	その他

`POST` : `/file/upload`

概要

ファイルをアップロード。

注意

このファイルアップロードは、テンポラリ環境にアップロードされるだけの処理となるためこの時点でご利用のmillvi環境へのアップロードは実施されません。ご利用のmillvi環境へアップロードするには、/file/uploadで取得したfilekeyをもとにcontents/create_videoやcontents/create_imageを実行する必要があります。

エンコード処理までの流れ：/file/uploadでfilekeyを取得＞contents/create_videoで入力クエリにfilekeyを指定＞millvi環境へアップロード（エンコード処理）＞コンテンツ登録

カテゴリ

ファイル

入力

ファイルデータをname=”file”として指定します。（ファイルは1つだけ指定できます）
multipart/form-dataメディアタイプでPOSTメソッドでリクエストを送信する必要があります。

クエリ
form-data入力例

タイプ	内容
ticket (required)	loginメソッドで取得できるチケット文字列
file (required)	アップロードするファイル

multipart/form-dataの例（ファイル部分のみ）

Content-Disposition: form-data; name=”file”; filename=”test.wmv”

Content-Type: application/octet-stream
Content-Transfer-Encoding: binary

(test.wmvのデータ)

クエリ

名前	値
ftp	動画ファイルのFTPパスを指定する multipart/form-dataでの実ファイルアップロードの代わりにFTPパスを指定できる(省略可)
ftp_delete	動画ファイルのFTPパスを指定する `1`を指定した場合動画の登録完了時に、”ftp”で指定された動画ファイルを削除する

出力

※CSVのみ。1行のみ。
（ローカルファイル名）,（ファイルキー）,（ファイルタイプ）

エラーコード

/file/uploadが以下のエラーコードを返却する可能性があります。（JSONまたはXML形式）

レスポンス内容

code要素	意味
`invalid_file`	ファイルのサイズが大きすぎます
`invalid_file`	ファイルは一部のみしかアップロードされていません
`invalid_file`	ファイルは正しくアップロードされませんでした
`invalid_file`	テンポラリフォルダがありません
`invalid_file`	ファイルサイズが0です
`server_error`	ディスクへの書き込みに失敗しました
`server_error`	PHPの拡張モジュールがファイルのアップロードを中止しました
`server_error`	ファイルが正しく送信されませんでした
`badfiletype`	ファイルの拡張子が不正です
`badfileformat`	動画ファイルではありません
`upload_video_limit_exceeded`	アップロード数制限に達しました

ステータス

有効

目次