本ドキュメントははてなブックマークにおけるフィード仕様を解説するものです。主にはてなスタッフがその作成と更新を行っています。
なお、現在はてなブックマークで採用しているAtomフィードのバージョンは、ドラフトバージョンです。最新のAtomフィードの仕様に合わせて、後日フィードのフォーマットが変更になる可能性があります。ご了承ください。
2005年7月5日に、はてなブックマークのフィード仕様を拡張いたしました。主な拡張内容は以下の通りになります。
以上の機能を各ユーザー毎のブックマークの RSS/Atom フィード、またはてなブックマークAtomAPIにおけるFeedURIに追加しました。以下のURLが拡張対象となります。(例はユーザー naoya のフィード)
また、2006年11月1日には上記拡張に追加する形で
を追加しています。
RSS/Atomフィードにタグをあらわす要素が追加されました。各エントリー毎に dc:subject 要素として表現されます。(拡張以前は dc:subject はエントリーのカテゴリーを表していましたが、拡張後はタグを表すよう変更となりました。)
<dc:subject>hatena</dc:subject> <dc:subject>blog</dc:subject>
フィードのページングを、クエリパラメータにより可能としました。
と、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" />
HTTP GET のクエリパラメータを操作することで、フィード取得のための条件を指定することができます。
が可能です。以下に例を示します。
ATomAPI の EditURI に対して HTTP GET でクエリパラメータで url を指定することで、指定した url のエントリーの内容を取得することができるようになりました。
任意の URI のブックマークの EditURI を取得する場合などに利用することができます。