はてなブックマークフィード仕様
本ドキュメントに関する注意事項
本ドキュメントははてなブックマークにおけるフィード仕様を解説するものです。主にはてなスタッフがその作成と更新を行っています。
なお、現在はてなブックマークで採用しているAtomフィードのバージョンは、ドラフトバージョンです。最新のAtomフィードの仕様に合わせて、後日フィードのフォーマットが変更になる可能性があります。ご了承ください。
変更履歴
- 2006年11月1日 「クエリパラメータによるフィードの絞り込み機能」に URL での絞込みについて追記
- 2005年12月12日 はてなブックマーク件数取得APIへのリンクを追加
- 2005年7月5日 リリース
はてなブックマークのフィード仕様拡張について
2005年7月5日に、はてなブックマークのフィード仕様を拡張いたしました。主な拡張内容は以下の通りになります。
- 各アイテムへの dc:subject によるタグの追加
- ページング機能のサポート
- クエリパラメータによるフィードの絞り込み機能
- タグによる絞込みフィード取得機能のサポート
- 検索語句による絞り込みフィード取得機能のサポート
- 日付指定によるフィード取得機能のサポート
- AtomAPI EditURI への URL クエリ
以上の機能を各ユーザー毎のブックマークの RSS/Atom フィード、またはてなブックマークAtomAPIにおけるFeedURIに追加しました。以下のURLが拡張対象となります。(例はユーザー naoya のフィード)
- http://b.hatena.ne.jp/naoya/rss
- http://b.hatena.ne.jp/naoya/atomfeed
- http://b.hatena.ne.jp/atom/feed (AtomAPI の FeedURI)
また、2006年11月1日には上記拡張に追加する形で
- クエリパラメータでのURL指定によるフィードの絞込み機能
を追加しています。
dc:subject によるタグ表現
RSS/Atomフィードにタグをあらわす要素が追加されました。各エントリー毎に dc:subject 要素として表現されます。(拡張以前は dc:subject はエントリーのカテゴリーを表していましたが、拡張後はタグを表すよう変更となりました。)
<dc:subject>hatena</dc:subject> <dc:subject>blog</dc:subject>
- タグが複数ある場合は、dc:subject要素は複数定義されます。
- タグが存在しない場合は dc:subject要素は省略されます。
- RSSフィードでは dc:subject に加えて taxo:topis 要素にてリソース表現を行っています。
フィードのページング機能
フィードのページングを、クエリパラメータにより可能としました。
と、of パラメータにオフセットを指定することで過去のフィードを取得することができます。なお、1ページごとにエントリーが20件出力されます。
Atomフィードでは、link要素により前後ページのURLを取得することも可能です。
<link rel="prev" type="application/atom+xml" href="http://b.hatena.ne.jp/naoya/atomfeed?of=0" /> <link rel="next" type="application/atom+xml" href="http://b.hatena.ne.jp/naoya/atomfeed?of=40" />
- prev属性が前のページ
- next属性が後のページ
- 前、後にそれ以上エントリーが存在しない場合はlink要素はそれぞれ表示されません。
クエリパラメータによるフィードの絞り込み機能
HTTP GET のクエリパラメータを操作することで、フィード取得のための条件を指定することができます。
- タグによる絞込みフィード取得機能のサポート
- 検索語句による絞り込みフィード取得機能のサポート
- 日付指定によるフィード取得機能のサポート
- URL指定によるフィード取得機能のサポート
が可能です。以下に例を示します。
- http://b.hatena.ne.jp/naoya/atomfeed?tag=blog
- 「blog」タグのエントリーをAtomフィードで取得します。(ページングあり)
- http://b.hatena.ne.jp/naoya/atomfeed?word=Perl
- 「Perl」での検索結果をAtomフィードで取得します。(ページングなし)
- http://b.hatena.ne.jp/naoya/atomfeed?date=20050701
- 2005年7月1日分のブックマークをAtomフィードで取得します。
- Atomフィードではlink要素により前後の日付が取得可能です。
- date=latest とすることでブックマーク中の最新の日付のフィードが取得可能です。
- http://b.hatena.ne.jp/naoya/atomfeed?url=http://search.cpan.org/
- search.cpan.org のエントリーだけに絞り込んだAtomフィードを取得します。
- http://b.hatena.ne.jp/naoya/rss?tag=blog
- RSSフィードに対するクエリ。Atomフィード同様 tag, word, date, url をサポートしています。
- http://b.hatena.ne.jp/atom/feed?tag=blog
- AtomAPI の FeedURI に対するクエリ。tag, word, date をサポートしています。
AtomAPI EditURI への URL クエリ
ATomAPI の EditURI に対して HTTP GET でクエリパラメータで url を指定することで、指定した url のエントリーの内容を取得することができるようになりました。
任意の URI のブックマークの EditURI を取得する場合などに利用することができます。