動画コンテンツのAPI処理に関する進捗状況を確認するAPIです。
■設定情報
■APIリンク書式
https://file-platform.stream.co.jp/writeapi/status/[アップロードキー]
■プロトコル
https (UTF-8)
(GET or POST)
■引数
| 項目名 | 必須 | 説明 | デフォルト値 | フォーマット |
| mid | ○ | 動画ID | --- | なし |
| callback | --- | callbackURL | 空白 | 全角半角、500文字 |
| mail_to | --- | メールアドレス | --- | 半角、255文字 |
| mail_subject | --- | メール件名 | トランスコード終了 | 全角半角、255文字 |
| mail_body | --- | メール本文 | トランスコード処理が 完了しました。 mid: %eqMailMid% error: %eqErrorCode% |
全角半角、1000文字 |
| mail_contenttype | --- | コンテンツタイプ | text/plain; charset=\"utf-8\" |
半角、255文字 |
■戻り値
「認証API以外のレスポンス内容」を参照
■ご留意点
- 『status』APIは『mid』『callback』をパラメータとして、リクエスト後即座に『callback』URLに完了通知を行います。
- トランスコードが完了していないものについては通知を行わず、通常の『status』APIと同じレスポンスを返します。
- 『upload』APIで既に『callback』が指定された場合は、『callback』の内容を上書きする仕組となっています。
- 『upload』APIで既に『mail_to』が指定された場合は、『mail_to』の内容を上書きする仕組となっています。