ビデオリストの取得（XML形式）
ビデオリストの取得API（XML形式）で取得できるデータの種類を詳しくご説明します。
リクエストURL
- 「:uid」で指定したユーザーIDで投稿されたビデオリストを取得します。
- 「:sid」で指定したサイトIDで投稿されたビデオリストを取得します。
- 「:srt」で指定したソート順でビデオリストを取得します。
- 「:pgcnf」で指定した最大取得件数でビデオリストを取得します。
- 「:ccl」で指定したCCライセンスIDのビデオリストを取得します。
- 「:s1」で指定した文字列が「タイトル」もしくは「説明コメント」に含まれるビデオリストを取得します。
- 「:recommend」に1を指定するとおすすめビデオリストを取得します。
リクエストパラメータ
| パラメータ | 項目名 | 説明 | 必須 | 値 | デフォルト値 |
|---|---|---|---|---|---|
| uid | ユーザーID | ユーザーのID ※ユーザーIDの確認方法についてはこちらをご覧ください。 |
- | 文字列 | - |
| sid | サイトID | サイトのID ※サイトIDの発行については、こちらをご覧下さい。 |
- | 文字列 | - |
| srt | ソート順 | 以下のソート順を選択できます。 新着順：new 再生回数順：access 評価順：evaluation ランダム：random |
- | 文字列 | new |
| pgcnf | 最大取得件数 | 以下の最大取得件数の中から選択できます。 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 30, 40, 50, 60, 70, 80, 90, 100 |
- | 数値 | 100 |
| ccl | CCライセンス | 以下のCCライセンスの中から選択できます。 表示(by)：6 表示−継承(by-sa)：5 表示−改変禁止(by-nd)：4 表示−非営利(by-nc)：3 表示−非営利−継承(by-nc-sa)：2 表示−非営利−改変禁止(by-nc-nd)：1 |
- | 数値 | - |
| s1 | 検索文字列 | タイトル、もしくは説明コメントに含まれる文字列を指定してください。 例：「ねこ」 ※URLEncodeする場合には、文字コードをWindows-31Jで実施してください。 |
- | 数値 | - |
| recommend | おすすめフラグ | "1"を指定すると、おすすめビデオリストを取得します。 | - | 数値 | - |
レスポンス
| パラメータ | 項目名 | 値 |
|---|---|---|
| response | - | - |
| status | statusタグ内は、共通仕様の応答メッセージを参照してください。 | - |
| result | - | - |
| video | - | - |
| id | ビデオのID | 文字列 |
| title | ビデオのタイトル | 文字列 |
| user_id | ユーザーID | 文字列 |
| user_name | ユーザー名 | 文字列 |
| site_id | サイトID | 文字列 |
| upload_time | 公開日時 | 日時 |
| duration | 再生時間（秒） | 数値 |
| view_count | 再生回数 | 数値 |
| rating_avg | 評価平均点 | 数値 |
| rating_sum | 評価合計 | 数値 |
| rating_count | 評価回数 | 数値 |
| description | 説明コメント | 文字列 |
| credit | クレジット | 文字列 |
| tags | タグのリスト | - |
| tag | タグ | - |
| name | タグ名 | 文字列 |
| url | タグURL | URL |
| license | CCライセンス名 | 文字列 |
| download_url | ダウンロードURL | URL |
| category_id | カテゴリID | 数値 |
| category_name | カテゴリ名 | 文字列 |
| iroha_genre_id | イロハジャンルID | 数値 |
| iroha_genre_name | イロハジャンル名 | 文字列 |
| recommend | おすすめフラグ | 真偽値 |
| thumbnail_url_medium | サムネイル画像(中)のURL 160 × 120 ピクセル |
URL |
| thumbnail_url_small | サムネイル画像(小)のURL 80 × 60 ピクセル |
URL |
| thumbnail_url_large | サムネイル画像(大)のURL 480 × 360 ピクセル |
URL |
| url | 詳細画面のURL | URL |
| p_url | プレーヤーのみの画面のURL | URL |
| player | プレーヤー | 文字列 |
サンプルリクエストURL
「uid=0000000310」で投稿されたビデオリストをランダム「srt=random」に1件「pgcnf=1」取得するには次のURLにアクセスします。
サンプルレスポンス
以下は、リクエストパラメータ「uid=0000000310」「srt=random」「pgcnf=1」のリクエストに対するレスポンスです。
データが存在しない場合
指定したパラメータでのデータ存在しない時は下記の様な結果が返って来ます。
ステータスのコードについてはステータスコードを参照してください。
