サムネイル一覧取得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による出力となります |