@niftyビデオ共有のAPI－ビデオ詳細情報の取得（XML形式）　ウェブサービス：@nifty

リクエストURL

「:id」で指定したビデオIDのビデオ詳細情報を取得します。

リクエストパラメータ

パラメータ	項目名	説明	必須	値	デフォルト値
id	ビデオID	ビデオのID	○	文字列	-

レスポンス

パラメータ	項目名	値
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	プレーヤー	文字列
comment_count	コメントの回数	数値
comment_list	コメントリスト	-
comment	コメント	-
author	コメント投稿者	文字列
text	コメント内容	文字列
time	コメント日時	日時

サンプルリクエストURL

ビデオIDが「id=070416008897」のビデオ詳細情報を取得するには次のURLにアクセスします。

サンプルレスポンス

以下は、リクエストパラメータ「id=070416008897」のリクエストに対するレスポンスです。

HTTP/1.1 200 OK
Content-Type: application/xml;charset=Windows-31J
:

<?xml version="1.0" encoding="Shift_JIS"?>
<response>
  <status>
    <code>200</code>
    <message>OK</message>
    <language>ja</language>
  </status>
  <result>
    <video>
      <id>070416008897</id>
      <title><![CDATA[@niftyビデオ共有PVお手玉編]]></title>
      <user_id>0000000310</user_id>
      <user_name><![CDATA[@niftyビデオ共有]]></user_name>
      <site_id></site_id>
      <upload_time>2007-04-16T17:26:00+09:00</upload_time>
      <duration>23</duration>
      <view_count>659</view_count>
      <rating_avg>3.0</rating_avg>
      <rating_sum>9</rating_sum>
      <rating_count>3</rating_count>
      <description><![CDATA[@niftyビデオ共有のプロモーションビデオ。]]></description>
      <credit><![CDATA[企画：ニフティ+AC部、制作：AC部]]></credit>
      <tags>
        <tag>
          <name><![CDATA[AC部]]></name>
          <url>http://video.nifty.com/cs/catalog/video_metadata/tagview/lst/srt_new/pgcnf_9/1.htm?tag=AC%95%94</url>
        </tag>
        <tag>
          <name><![CDATA[にゃんこ]]></name>
          <url>http://video.nifty.com/cs/catalog/video_metadata/tagview/lst/srt_new/pgcnf_9/1.htm?tag=%82%C9%82%E1%82%F1%82%B1</url>
        </tag>
        <tag>
          <name><![CDATA[ねこ]]></name>
          <url>http://video.nifty.com/cs/catalog/video_metadata/tagview/lst/srt_new/pgcnf_9/1.htm?tag=%82%CB%82%B1</url>
        </tag>
        <tag>
          <name><![CDATA[みてにゃ]]></name>
          <url>http://video.nifty.com/cs/catalog/video_metadata/tagview/lst/srt_new/pgcnf_9/1.htm?tag=%82%DD%82%C4%82%C9%82%E1</url>
        </tag>
        <tag>
          <name><![CDATA[ビデオ共有]]></name>
          <url>http://video.nifty.com/cs/catalog/video_metadata/tagview/lst/srt_new/pgcnf_9/1.htm?tag=%83%72%83%66%83%49%8B%A4%97%4C</url>
        </tag>
        <tag>
          <name><![CDATA[ビデオ共有PV]]></name>
          <url>http://video.nifty.com/cs/catalog/video_metadata/tagview/lst/srt_new/pgcnf_9/1.htm?tag=%83%72%83%66%83%49%8B%A4%97%4CPV</url>
        </tag>
        <tag>
          <name><![CDATA[共有PV]]></name>
          <url>http://video.nifty.com/cs/catalog/video_metadata/tagview/lst/srt_new/pgcnf_9/1.htm?tag=%8B%A4%97%4CPV</url>
        </tag>
      </tags>
      <license>by-nc-sa</license>
      <download_url><![CDATA[http://dl.video.nifty.com/download.cgi?user_id=0000000310&catalog_id=070416008897]]></download_url>
      <category_id>21</category_id>
      <category_name>ニフティ</category_name>
      <iroha_genre_id>0</iroha_genre_id>
      <iroha_genre_name></iroha_genre_name>
      <recommend>true</recommend>
      <thumbnail_url_medium>http://dl.video.nifty.com/0/c285228a8f522e9639a4a02dc6c77271/video/070416008897/thumbnail/0m.jpg</thumbnail_url_medium>
      <thumbnail_url_small>http://dl.video.nifty.com/0/c285228a8f522e9639a4a02dc6c77271/video/070416008897/thumbnail/0s.jpg</thumbnail_url_small>
      <thumbnail_url_large>http://dl.video.nifty.com/0/c285228a8f522e9639a4a02dc6c77271/video/070416008897/thumbnail/0l.jpg</thumbnail_url_large>
      <url>http://video.nifty.com/cs/catalog/video_metadata/catalog_070416008897_1.htm</url>
      <p_url>http://video.nifty.com/cs/catalog/video_metadata/p/catalog_070416008897_1.htm</p_url>
      <player><![CDATA[<script language="javascript" type="text/javascript" src="http://dl.video.nifty.com/js/player.js?user_id=0000000310&catalog_id=070416008897&lg=0&width=480&height=392"></script><noscript><a href="http://video.nifty.com/cs/catalog/video_metadata/catalog_070416008897_1.htm" target="_blank">@niftyビデオ共有PVお手玉編</a></noscript>]]></player>
      <comment_count>4</comment_count>
      <comment_list>
        <comment>
          <author><![CDATA[挽きたて工房]]></author>
          <text><![CDATA[こめこめ]]></text>
          <time>2007-10-31T10:37:46+09:00</time>
        </comment>
        <comment>
          <author><![CDATA[JAVA]]></author>
          <text><![CDATA[TEST]]></text>
          <time>2007-05-24T19:19:02+09:00</time>
        </comment>
        <comment>
          <author><![CDATA[さとぽん]]></author>
          <text><![CDATA[にゃんこ、かわユス！]]></text>
          <time>2007-05-23T13:56:28+09:00</time>
        </comment>
        <comment>
          <author><![CDATA[utrecht]]></author>
          <text><![CDATA[にゃんこのお尻がかわいい！
<br />このユルイ感じ、いいですね～]]></text>
          <time>2007-04-27T15:37:03+09:00</time>
        </comment>
      </comment_list>
    </video>
  </result>
</response>

データが存在しない場合

指定したパラメータでのデータ存在しない時は、HTTP応答が404となります。
ステータスのコードについてはステータスコードを参照してください。

HTTP/1.1 404 Not Found
Content-Type: application/xml;charset=Windows-31J
:

<?xml version="1.0" encoding="Shift_JIS" ?>
<response>
  <status>
    <code>404</code>
    <message>データが見つかりません。</message>
    <language>ja</language>
  </status>
  <result>
  </result>
</response>

@niftyのウェブサービスを使ってアプリケーションを作ってみよう！

ビデオ詳細情報の取得（XML形式）

リクエストURL

リクエストパラメータ

レスポンス

サンプルリクエストURL

サンプルレスポンス

データが存在しない場合

提供API

メニュー

開発者ブログ

関連サービス