getflvの戻り値についてまとめ(2010年8月版)
2. getflv API
getflv APIは、特定の動画に対する、動画配信サーバー・メッセージサーバー・投稿者フィルタ等の情報を取得する事ができるAPIである。
getflv APIを用いて情報を取得する場合、以下のURLに対してGETリクエストを実行する。
http://flapi.nicovideo.jp/api/getflv/sm*****
なお、対象の動画がSWFの場合は以下のようにしてリクエストを実行する必要がある。
http://flapi.nicovideo.jp/api/getflv/nm*****?as3=1
getflv APIへのアクセスの手順等については下記エントリを参照の事。
3. getflv APIの戻り値の形式
getflv APIへのアクセスの戻り値は文字列で得られる。以下に、sm8702(いただきじゃんがりあんR - OP 「Love Cheat!」 【高画質】)についての情報取得結果を示す。
thread_id=1173206704 &l=111 &url=http://smile-pcm31.nicovideo.jp/smile?v=8702.9279 &link=http://www.smilevideo.jp/view/8702/573999 &ms=http://msg.nicovideo.jp/7/api/ &user_id=<ユーザーID> &is_premium=1 &nickname=<ニックネーム> &time=1282199207 &done=true &feedrev=b852b &ng_up=*はー=はあああああああああああああああああああああああああああああ &*どー=どおおおおおおおおおおおおおおおおおおおおおおおおおおおおお &*らっちー=らっち〜☆ミ らっち〜☆ミ &*つー=つううううううううううううううううううううううううううううううううううううううううう &hms=hiroba07.nicovideo.jp &hmsp=2529 &hmst=1000000125 &hmstk=1282199267.MpPPtW9DzfDKV3sgSiFOIaEjp6o &rpu={"count":928779, "users":["<ユーザー名1>", "<ユーザー名2>", ... , "<ユーザー名n>"], "extra":0}
※値はそれぞれURIエンコードされているので、適宜デコードする。
※戻り値に改行及びインデントは含まれないが、見やすさを優先するため改行及びインデントを挿入してある。
thread_id
コメント群のID
l
動画の長さ(秒)
url
動画配信サーバーのURL
link
smilevideoの当該動画ページのURL。違反報告ページ。
ms
メッセージサーバーのURL
user_id
ユーザー(それはあなたです!)のID
is_premium
ユーザーがプレミアム会員かどうか。1のときプレミアム、0のときは通常。
nickname
ユーザーのニックネーム
time
動画の投稿日。1970/1/1 0時0分0秒(UTC)からの経過秒数。
done
不明。trueかfalseが入る。falseの時は動画を閲覧できない?
feedrev
不明。
ng_up
投稿者フィルタ情報。*AAAA=BBBBの形式で、動画の閲覧者が投稿したコメントが"AAAA"であれば、それを"BBBB"に置き換える。
hms
遊園地サーバーのURL?
hmsp
遊園地関連の何か。不明。
hmst
遊園地関連の何か。不明。
hmstk
遊園地関係の何か。チケット?不明。
rpu
ユーザー名の一覧。なんのための一覧かは不明。
4. 公式動画の場合の追加情報
また、公式動画の場合、以下の属性が含まれる場合がある。
&needs_key=1 &optional_thread_id=1254473671
needs_key
動画に対するコメント取得の際に別途値が必要かどうか。公式動画のコメント取得については下記ページを参照の事。
optional_thread_id
公式動画のスレッドID。
5.最後に
誤りや改善点、ご意見、「不明って書いてあるけど、この値は〜〜だよ!」などありましたら、お気軽にコメントください。