メディア情報一覧の取得

メディア情報一覧を取得します。

GET /api/1/videos/media

ノート

この API は、認証によって挙動が異なります。
Digest 認証に成功すると、パラメータに合致し、“削除されていない”メディアの一覧を返します。
Referer+Key での認証が成功すると、パラメータに合致し、ステータスが“有効になっている”メディアの一覧を返します。

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

  • tile_quality

    • 一覧取得するタイル品質
      tile_quality の指定がない場合は全タイル品質が適用
      品質は 1 / 2 / 3 から選択可能

  • level

    • 一覧取得するタイルのレベル
      level の指定がない場合は全レベルのタイルが適用
      レベルは 1 / 2 / 3 / 4 から選択可能

  • media_id

    • 一覧取得するタイルのID（部分一致）
      指定された数字をメディアIDに含むメディアがを対象とする．

Response

  • status

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

  • has_next

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

  • total

    • 総メディア数

  • info

    • メディア情報

      • id

        • メディアID

      • caption

        • キャプション

      • description

        • ディスクリプション

      • tags

        • タグ

      • thumbnail_url

        • サムネイルのURL

        • サムネイルURLのルールは{メディアID}_{サムネイルの高さ}_{指定されたフレーム位置}.jpgとなる。また、本fvLIBRARY APIを使用して投稿されたメディアは全て30FPSのタイルに変換されます。そのため投稿したオリジナルメディアのフレーム位置とfabric videoであるmp4のフレーム位置は異なる可能性が有ります。

      • sound_url

        • 音声データへのURL

      • tile_info

        • タイル情報
          • version
            • fvエンコーダのバージョン
          • type
            • タイル種別
          • fps
            • fps
          • frames
            • 総フレーム数
          • level
            • タイルレベル(配列)
          • tile_quality
            • タイル品質(配列)
          • create_date
            • 作成日時
          • update_date
            • 更新日時
          • status
            • タイルのステータス

      • create_date

        • 作成日時

      • update_date

        • 更新日時

      • status

        • メディアのステータス
          0 : 無効
          1 : 有効

Request Example

GET
https://example.com/api/1/videos/media?page=30&num=2

Sample Curl Command

  • Basic認証を使用した方法
curl --basic -u {your account}:{your password} "https://example.com/api/1/videos/media?page=1&num=-10"
  • AccessToken認証を使用した方法
curl "https://example.com/api/1/videos/media?page=1&num=-10" \
-H "Authorization: Bearer {your access_token}"

Response Example - JSON

{
  "status":"success",
  "has_next":true,
  "total":59,
  "info":[
    {
      "id":"2",
      "caption":"test caption",
      "tags":[
      "tag1",
      "tag2"
      ],
      "thumbnail_url":[
        "http:\/\/example.com\/r\/p\/images\/tt\/2_144_0.jpg"
      ],
      "sound_url":[
        "http:\/\/example.com\/r\/p\/audios\/ta\/2_1.m4a"
      ],
      "tile_info":{
        "version":"3",
        "type":"hd144",
        "fps":30,
        "frames":420,
        "level":[
          1
        ],
        "tile_quality":[
         1,
         2
        ],
        "create_date":"2013-01-11 12:15:41",
        "update_date":"2013-01-11 12:15:44",
        "status":1
      },
      "create_date":"2013-01-11 12:15:41",
      "update_date":"2013-01-30 13:49:26",
      "status":"1"
      },
      {
        "id":"3",
        "caption":"caption test",
        "tags":[
        "test tag1",
        "test tag2"
        ],
        "thumbnail_url":[
        "http:\/\/example.com\/r\/p\/images\/tt\/3_144_0.jpg"
        ],
        "sound_url":[
        "http:\/\/example.com\/r\/p\/audios\/ta\/3_1.m4a"
        ],
        "tile_info":{
        "version":"3",
        "type":"hd144",
        "fps":30,
        "frames":360,
        "level":[
          1
        ],
        "tile_quality":[
         2
        ],
        "create_date":"2013-01-11 12:16:12",
        "update_date":"2013-01-11 12:16:16",
        "status":1
      },
      "create_date":"2013-01-11 12:16:12",
      "update_date":"2013-01-11 12:16:15",
      "status":"1"
    }
  ]
}

Response Example - XML

<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>success</status>
<has_next>1</has_next>
<total>59</total>
<info>
  <entry>
    <id>2</id>
    <caption>test caption</caption>
    <tags>
      <entry>tag1</entry>
      <entry>tag2</entry>
    </tags>
    <thumbnail_url>
      <entry>http://example.com/r/p/images/tt/2_144_0.jpg</entry>
    </thumbnail_url>
    <sound_url>
      <entry>http://example.com/r/p/audios/ta/2_1.m4a</entry>
    </sound_url>
    <tile_info>
      <version>3</version>
      <type>hd144</type>
      <fps>30</fps>
      <frames>420</frames>
      <level>
       <entry>1</entry>
      </level>
      <tile_quality>
       <entry>1</entry>
       <entry>2</entry>
      </tile_quality>
      <create_date>2013-01-11 12:15:41</create_date>
      <update_date>2013-01-11 12:15:44</update_date>
      <status>1</status>
    </tile_info>
    <create_date>2013-01-11 12:15:41</create_date>
    <update_date>2013-01-30 13:49:26</update_date>
    <status>1</status>
  </entry>
  <entry>
    <id>3</id>
    <caption>test caption</caption>
    <tags>
      <entry>test tag1</entry>
      <entry>test tag2</entry>
    </tags>
    <thumbnail_url>
      <entry>http://example.com/r/p/images/tt/3_144_0.jpg</entry>
    </thumbnail_url>
    <sound_url>
      <entry>http://example.com/r/p/audios/ta/3_1.m4a</entry>
    </sound_url>
    <tile_info>
      <version>3</version>
      <type>hd144</type>
      <fps>30</fps>
      <frames>360</frames>
      <level>
        <entry>1</entry>
      </level>
      <tile_quality>
        <entry>1</entry>
      </tile_quality>
      <create_date>2013-01-11 12:16:12</create_date>
      <update_date>2013-01-11 12:16:16</update_date>
      <status>1</status>
    </tile_info>
    <create_date>2013-01-11 12:16:12</create_date>
    <update_date>2013-01-11 12:16:15</update_date>
    <status>1</status>
  </entry>
</info>
</response>