タイル情報一覧の取得

タイル情報の一覧を取得します。

GET /api/1/videos/tile

Parameters

  • output_type

    • Response 形式
      • x : XML 形式で出力
      • 指定無し : JSON 形式で出力

  • page [必須]

    • 表示するページ位置。1 以上の整数。[詳細]

  • num [必須]

    • 1 ページあたりの件数。[詳細]

  • tile_type

    • 一覧取得するタイル種別
      tile_type の指定がない場合は全タイル種別が適用
      hd 16:9 / sd 4:3 / r 3:2 / s 1:1

  • level

    • 一覧取得するタイルレベル。
      level の指定がない場合は全レベル（1〜4）が適用
      1 / 2 / 3 / 4

  • tile_quality

    • 一覧取得するタイル品質。
      tile_qualityの指定がない場合は，全品質（1〜3）が適用
      1 / 2 / 3

Response

  • status

    • 処理結果
      success : 成功
      それ以外 : 失敗

  • has_next

    • 次ページの有無
      true : 有
      false : 無

  • total

    • 総メディア数

  • info

    • タイル情報

      • media_id

        • メディアID

      • version

        • fvエンコーダのバージョン

      • type

        • タイル種別

      • fps

        • fps

      • frames

        • 総フレーム数

      • level

        • タイルレベル （配列）

      • tile_quality

        • タイル品質 （配列）

      • create_date

        • 作成日時

      • update_date

        • 更新日時

      • status

        • タイルのステータス
          0 : 無効
          1 : 有効
          3 : タイル未生成状態
          4 : タイル生成失敗

Request Example

GET
https://example.com/api/1/videos/tile?page=1&num=3

Sample Curl Command

  • Basic認証を使用した方法
curl --basic -u {your account}:{your password} "https://example.com/api/1/videos/tile?page=1&num=10&tile_quality=2&level=2&tile_type=hd"
  • AccessToken認証を使用した方法(media_idsとlevelsで指定)
curl "https://example.com/api/1/videos/tile?page=1&num=10&tile_quality=2&level=2&tile_type=hd" \
-H "Authorization: Bearer {your access_token}"

Response Example - JSON

{
"status":"success",
"has_next":true,
"total":58,
"info":[
         {
           "media_id":10,
           "version":"3",
           "type":"s64",
           "fps":30,
           "frames":150,
           "level":[
             1,2
           ],
           "tile_quality":[
             2
           ],
           "create_date":"2012-10-01 16:57:09",
           "update_date":"2012-10-01 16:57:14",
           "status":1
         },
         {
           "media_id":11,
           "version":"3",
           "type":"s64",
           "fps":30,
           "frames":150,
           "level":[
             1,2
           ],
           "tile_quality":[
             2
           ],
           "create_date":"2012-10-01 16:57:09",
           "update_date":"2012-10-01 16:57:14",
           "status":1
         },
         {
           "media_id":12,
           "version":"3",
           "type":"s64",
           "fps":30,
           "frames":150,
           "level":[
             1,3
           ],
           "tile_quality":[
             2
           ],
           "create_date":"2012-10-01 16:57:09",
           "update_date":"2012-10-01 16:57:14",
           "status":1
         }
       ]
}

Response Example - XML

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>success</status>
  <has_next>1</has_next>
  <total>58</total>
  <info>
    <entry>
      <media_id>10</media_id>
      <version>3</version>
      <type>s64</type>
      <fps>30</fps>
      <frames>150</frames>
      <level>
       <entry>1</entry>
      </level>
      <tile_quality>
        <entry>2</entry>
      </tile_quality>
      <create_date>2012-10-01 16:57:09</create_date>
      <update_date>2012-10-01 16:57:14</update_date>
      <status>1</status>
    </entry>
    <entry>
      <media_id>11</media_id>
      <version>3</version>
      <type>s64</type>
      <fps>30</fps>
      <frames>150</frames>
      <level>
       <entry>1</entry>
       <entry>2</entry>
      </level>
      <tile_quality>
       <entry>2</entry>
      </tile_quality>
      <create_date>2012-10-01 16:57:09</create_date>
      <update_date>2012-10-01 16:57:14</update_date>
      <status>1</status>
    </entry>
    <entry>
      <media_id>12</media_id>
      <version>3</version>
      <type>s64</type>
      <fps>30</fps>
      <frames>150</frames>
      <level>
       <entry>1</entry>
       <entry>3</entry>
      </level>
      <tile_quality>
       <entry>2</entry>
      </tile_quality>
      <create_date>2012-10-01 16:57:09</create_date>
      <update_date>2012-10-01 16:57:14</update_date>
      <status>1</status>
    </entry>
  </info>
</response>