WriteAPIは、認証APIとそれ以外のAPIでレスポンス内容が異なります。
プロトコルステータスは全てのAPIで共通です。
■APIからのレスポンス内容詳細(認証APIを除く)
・MIME
Content-Type: application/json
・文字コード
UTF-8
・プロトコルステータス
ステータスコード | 状態 |
200 | 正常 |
404 | 認証エラー ※レスポンスデータはありません |
・レスポンスデータ
項目名 | JSON要素 | 説明 |
エラーコード | error_code | エラーコード ※詳細はエラーコード一覧に記載 |
詳細メッセージ | message | エラーメッセージ、受け付け内容 |
動画ID | mid | 動画ID |
進捗状況 | progress | トランスコードの進捗状況(0-100%で表示します) |
再生速度設定 | play_speed | 生成される動画の再生速度(0.5-2.0倍で表示します) |
・レスポンス内容サンプル
{"error_code":0,"message":"transcode processing","mid":xxx,"progress":0} |
・レスポンス内容サンプル(倍速動画生成の場合)
{ “transcode”:[ {“error_code”:0,”message”:”transcode processing”,”mid”:xxx, “transcode_id”:x,”progress”:0,”play_speed”:x.x}, {“error_code”:0,”message”:”transcode processing”,”mid”:xxx, “ transcode_id “:x,”progress”:0,”play_speed”:x.x}, {“error_code”:0,”message”:”transcode processing”,”mid”:xxx, “ transcode_id “:x,”progress”:0,”play_speed”:x.x} ] } |
※『transcode_id』を指定した場合のみ、上記のレスポンスを行います。
『transcode_id』を指定していない場合は、今まで通りのレスポンスを行います。
■エラーコード
エラーコードのメッセージとエラー内容を記載します。
エラーコード | メッセージ | 説明 |
9000 | transcode processing | トランスコード中または動画差し替え中(metaedit, thmbup) WriteAPI実行中(status) |
9011 | simultaneous connection restrictions | 同時接続過多(upload) |
9012 | upload limit | アップロード数制限(upload) |
9021 | (エラー項目) | パラメータエラー(upload, thumbup, metaedit) ※指定した任意IDが重複した場合など |
9022 | uncorresponded | 未対応コンテンツ(upload, thumbup) |
9501 | metaedit error | メタ変更中エラー(metaedit, witeapi_exec) |
9502 | thumbnail upload error | サムネイル更新中エラー(thmbup, witeapi_exec) |
9503 | unknown | 未登録、削除済み |
9523 | this movie is used to filetolive | 開催予定の疑似ライブで設定された、動画の削除を実行した場合の動画削除エラー |
その他のコード | --- | トランスコードエラー等 |