getthumbinfo についての解説は大百科の「ニコニコ動画API」を見ればたいていのことはわかるが、そこに書いてないことについて現在 (2014 年 2 月 4 日) におけるまとめをしておく。
リクエスト
"http://ext.nicovideo.jp/api/getthumbinfo/" + video_id
ポイント
まず、正常データとしては大きく分けると 2 パターンあり、
- ユーザー投稿動画
- チャンネル投稿動画
が存在する。少しだけ XML のユーザー情報が異なることに注意すればあとは同じ。
エラーデータとしては以下の 3 つを確認している。
- 削除された (DELETED)
- 見つからない or 不正な動画 (NOT_FOUND)
- コミュニティー動画 (COMMUNITY)
このような感じで、6 種類ぐらいのテストをすればいいと思われる。上に書いていない 1 種類のテストは、長時間動画のテストである。60 分を超える動画の場合も、「112:59」みたいな状態で表記され、1 時間 52 分 59 秒になるので注意。
なお、最後にエラーの場合の XML を示してこの記事を終了する。
実例
- DELETED
<?xml version="1.0" encoding="UTF-8"?>
<nicovideo_thumb_response status="fail">
<error>
<code>DELETED</code>
<description>deleted</description>
</error>
</nicovideo_thumb_response> - NOT_FOUND
<?xml version="1.0" encoding="UTF-8"?>
<nicovideo_thumb_response status="fail">
<error>
<code>NOT_FOUND</code>
<description>not found or invalid</description>
</error>
</nicovideo_thumb_response> - COMMUNITY
<?xml version="1.0" encoding="UTF-8"?>
<nicovideo_thumb_response status="fail">
<error>
<code>COMMUNITY</code>
<description>community</description>
</error>
</nicovideo_thumb_response>
最後に
user_id が省略されるらしい的なことが大百科にあったけどそれは事実なのかな? よくわからない。