ダイレクトフォームアップロード

目次

1. 概要
2. accesskeyの生成
3. サンプルコード（PHP）
4. エラーコード
5. 登録方法
6. 利用するWebAPI

概要 

HTMLのformフィールドから直接、ミルビィへ動画を登録することができます。
登録時には各種メタデータの他、別途accesskeyの指定が必要です。
ブラウザ環境によって2種類の登録方法（Locationタイプ / AJAXタイプ）が選べます。

accesskeyの生成

accesskeyの文字列は以下の内容になります。

サンプルコード（PHP）

$clientid = "demo";
$id_user = 1;
$expire = time() + (30 * 60);
$secretkey = "a7d2ef0a2f083a824b3b049b40b1231d045d9398";
$sign = sha1("{$clientid}/{$id_user}/{$expire}/{$secretkey}");
$accesskey = "v1,{$clientid},{$id_user},{$expire},{$sign}";

エラーコード

以下のエラーコードを返却する可能性があります。

レスポンス内容

登録方法

ダイレクトフォームアップロードはブラウザ環境によって2種類の登録方法（Locationタイプ / AJAXタイプ）が選べます。

Location タイプ

APIのURL例：　https://ccs.miovp.com/create_video form

フィールドから動画を登録します。
アップロード後に、id_contentsを伴って画面遷移します。

基本HTML

<form method="post" action="https://ccs.miovp.com/create_video?return_url=https://XXXX.XX.XX/XXXX" enctype="multipart/form-data">
  <input type="file" name="file"> <input type="submit" value="アップロード">
</form>

上記HTMLを基本に、リクエスト時にクエリーをフォームフィールドに付与します。 ※return_urlはクエリーと合わせて変更してください。

AJAX タイプ

APIのURL：　https://ccs.miovp.com/create_video

formフィールドから動画を登録します。
“XMLHttpRequest level2”でのご利用を想定しており、APIのレスポンスを直接受け取る事ができます。

基本HTML

<form method="post" action="https://ccs.miovp.com/create_video" enctype="multipart/form-data">
<input type="file" name="file" />
<input type="button" value="アップロード" />
</form>

上記HTMLを基本に、リクエスト時にクエリーをフォームフィールドに付与します。

注意事項

クエリーはLocationタイプの”return_url”を外してご使用ください。 ”return_url”を指定しないことで、AJAXタイプとなります。 レスポンスはデフォルトでJSON形式で出力されます。 （クエリーにxml=1を指定することでXML形式での出力も可能です。）

※AJAXタイプは対応ブラウザからのみ利用可能です。

利用するWebAPI

ダイレクトフォームアップロードでは、動画・画像の登録が可能です。 それぞれ以下のWebAPIをご利用ください。