サムネイル一覧取得APIを利用することで、
指定された動画IDに紐づく全サムネイル情報を取得することが出来ます。
■API呼び出しURL
http(s)://api01-platform.stream.co.jp/apiservice/getThumbnailList/?token=xxxx&各引数
■パラメータ
項目名 | 必須 | 説明 | フォーマット | デフォルト値 |
token | ○ | アカウント(CID)毎に 発行されたトークン |
文字列 | 無し |
mid | ○ |
動画ID |
半角数字 | 無し |
■レスポンス
項目名 | JSON要素 | 説明 | 備考 | |
コールバック |
searchResultEq |
JSONPコールバック関数名 |
||
レスポンスステータス | response_status | APIレスポンスステータス | ||
サムネイル数 |
thumbnail_num |
サムネイルの数 | ||
サムネイル情報 |
thumbnail |
サムネイル情報 | ||
サムネイルID |
thumbnail |
thumbnail_id |
サムネイルID | |
サムネイルURL |
thumbnail_url |
SSL用 サムネイルのURL |
||
サムネイルサイズ(縦) |
width |
サムネイルのサイズ(横) |
||
サムネイルサイズ(横) |
height |
サムネイルのサイズ(縦) |
||
切り出し位置 |
scene |
サムネイルの切り出し位置 |
※1 | |
サムネイル設定 |
mark |
サムネイルとして設定されているか |
||
ファイルサイズ |
filesize |
ファイルサイズ |
※トランスコード時に生成される黒サムネイルは「100」、アップロードした画像では、
切り出し位置が「0」となります。
■レスポンス例:正常時
searchResultEq( { "response_status":"2000" "thumbnail_sum":100, "meta":[{ "thumbnail_id":"1", "thumbnail_url":"https:\/\/ssl.webcdn.stream.co.jp\/testcid\/sample.jpg", "width":540, "height":" 960", "scene":50, "mark":true }, { "thumbnail_id":"1", "thumbnail_url":"https:\/\/ssl.webcdn.stream.co.jp\/testcid\/sample.jpg", ...省略... }, ] }); ※content-typeはJsonp出力時「application/javascript」、Json出力時「application/json」となります |
■レスポンス例:エラー時
searchResultEq({ "response_status":"1001", "thumbnail_sum":0 }); ※content-typeはJsonp出力時「application/javascript」、Json出力時「application/json」となります ※json標準のunicodeによる出力となります |