Tips : はてなブックマークAtomAPI

id:tsupoさんがはてなブックマークAtomAPIで色々書いてらっしゃるので、情報共有の意味を込めて、今まで培ってきた(っていうか2,3日しか触ってないけど)はてなブックマークAtomAPIのTipsについて書いてみる。

FeedURIの取得件数について

GET /atom/feed

で最近のエントリーを取得できますが、この件数は、はてなブックマークの設定画面で「件数別表示」のところで設定した件数になる模様。

過去のエントリーを取得したいとき

GET /atom/feed?of=数字

というリクエストを送ると、ブックマークのうち、数字+1件目から件数別表示で設定した件数分のエントリーを取得できます。こんなもんどこにも書いてないけどな(汗
何で分かったかというと、はてなの他のサービスがみんな"of=数字"ってつけるとページ遷移できるようになってるから。勘です、勘。

タグのデータの取り方

FeedURIからまとめてエントリーを取得する場合、タグの情報を取得できません。コメントの情報が入っているsummary要素のところには、タグ以外のコメントしか出てきません。でも、タグを取得するウラ技があったりします。それは、EditURIから個別にエントリーを取得すればよいのです。この場合、似たようなXMLが帰ってきますが、summary要素にはタグの情報も含めた(つまり、実際にコメント欄に入力したままの)データを取得出来ます。

ブックマークしたページのテキストを取得したいとき

コメント欄が空白のエントリーの場合、summary要素には、ブックマークしたページのテキストが入ってきます。

http://b.hatena.ne.jp/entry/http://

のページで表示されるのと同一のもののようです。
ページのテキストが返ってきたり、コメントの中身が返ってきたり、コメントの中身が返ってくるにしてもある場合にはタグがついてたりついてなかったり……、とすごい変な感じ。AtomAPIの仕様を知らないけど、1つの要素が色々な役割を演じているのはどうかと思うんですが……。