はてなブックマークAtomAPI

リクエスト

GET /atom

レスポンス

HTTP/1.1 200 OK
Content-Type: application/x.atom+xml

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://purl.org/atom/ns#">
  <link type="application/x.atom+xml" rel="service.post"
        href="http://b.hatena.ne.jp/atom/post" title="sampleのブックマーク" />
  <link type="application/x.atom+xml" rel="service.feed"
        href="http://b.hatena.ne.jp/atom/feed" title="sampleのブックマーク" />
</feed>

ブックマークのタイトルの編集について

PostURI による投稿時はブックマークのタイトルを編集することはできません。タイトルはlink要素に指定したURLから自動取得され設定されます。これは、はてなブックマークにおける各エントリーのタイトルが、全ユーザー共通であることを考慮し、タイトルを変更する場合はすでに設定されているタイトルを一度確認した上で編集を行っていただきたい故の仕様です。

ブックマークの任意のタイトルを編集するアプリケーションを実装する場合は、

1. PostURI POST でブックマークを投稿
2. EditURI GET でタイトルを取得
3. 2. で取得したタイトルを変更したい場合は、EditURI PUT でタイトルを変更

という手順でアプリケーションのユーザーに既存のタイトルを確認させた上で、EditURI にて変更してください。

リクエスト

POST /atom/post

<entry xmlns="http://purl.org/atom/ns#">
  <title>dummy</title>
  <link rel="related" type="text/html" href="http://www.example.com/" />
  <summary type="text/plain">サンプルコメントです</summary>
</entry>

レスポンス

• レスポンスは正常終了時としてHTTPステータス201を返します。
• サンプルのXXXXはURLにおける末尾の数値部(eid)に置き換えてください。

201 Created
Content-Type: application/x.atom+xml
Location: http://b.hatena.ne.jp/atom/edit/XXXX

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://purl.org/atom/ns#">
  <title>example.com</title>
  <link rel="related" type="text/html" href="http://www.example.com/" />
  <link rel="alternate" type="text/html" href="http://b.hatena.ne.jp/sample/20050407#XXXX" />
  <link rel="service.edit" type="application/x.atom+xml" href="http://b.hatena.ne.jp/atom/edit/XXXX" title="example.com" />
  <author>
    <name>sample</name>
  </author>
  <generator url="http://b.hatena.ne.jp/" version="0.1">Hatena::Bookmark</generator>
  <issued>2005-04-07T:18:36:00+9:00</issued>
  <id>tag:hatena.ne.jp,2005:bookmark-sample-XXXX</id>
  <summary type="text/plain">サンプルコメントです</summary>
</entry>

リクエスト

GET /atom/edit/XXXX

レスポンス

200 OK
Content-Type: application/x.atom+xml

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://purl.org/atom/ns#">
  <title>sampleのブックマーク</title>
  <link rel="related" type="text/html" href="http://www.example.com/" />
  <link rel="alternate" type="text/html" href="http://b.hatena.ne.jp/sample/20050407#XXXX" />
  <link rel="service.edit" type="application/x.atom+xml" href="http://b.hatena.ne.jp/atom/edit/XXXX" title="example.com" />
  <author>
    <name>sample</name>
  </author>
  <generator url="http://b.hatena.ne.jp/" version="0.1">Hatena::Bookmark</generator>
  <issued>2005-04-07T:18:36:00+9:00</issued>
  <id>tag:hatena.ne.jp,2005:bookmark-sample-XXXX</id>
  <summary type="text/plain">サンプルコメントです</summary>
</entry>

リクエスト

• title要素、summary要素は省略可能ですが、いずれか一方は存在している必要があります。
• タイトルの編集に関しては、先の「ブックマークのタイトルの編集について」を参照ください。

PUT /atom/edit/XXXX

<entry xmlns="http://purl.org/atom/ns#">
  <title>Sample Page</title>
  <summary type="text/plain">サンプルです。</summary>
</entry>

※特定のブックマークのURLの置換はEditURIへのPUTではサポートしていません。該当のブックマークの削除+新規投稿で対応してください。

レスポンス

200 OK

リクエスト

DELETE /atom/edit/XXXX

レスポンス

200 OK

リクエスト

GET /atom/feed

レスポンス

はてなブックマークがフィードしているAtomフィードと同様の結果を返します。ここでは省略します。