ブックマークの編集

既存のブックマークを編集することもできます。それには、「http：//b.hatena.ne.jp/atom/edit/ページのID」にPUTプロトコルでアクセスします。ページのIDは、ブックマークを追加したときに得られたID（数値）を使います。

また、アクセスの際には、リスト5のようなXMLを送信します。タイトルとコメントはどちらかを省略することができます。
--------------------------------------------------------------------------------
【リスト5】ブックマークを編集する際に渡すデータ

　　　ページのタイトル
　　　

--------------------------------------------------------------------------------

ブックマークのコメントを編集するプログラムを作ると、リスト6のようになります。5行目の「ページのID」と6行目の「コメント」を書き換えると、動作を試すことができます。
--------------------------------------------------------------------------------
【リスト6】ブックマークのコメントを編集するプログラム
require_once 'HTTP/Request.php';
require_once 'auth_wsse.php';

$eid = ページのID;
$comment = 'コメント';
$req =& new HTTP_Request("http：//b.hatena.ne.jp/atom/edit/${eid}");
$req->setMethod(HTTP_REQUEST_METHOD_PUT);
set_auth_wsse($req);
$postdata = <<< HERE

　　　

${comment}

HERE;
$req->addRawPostData($postdata);
if (PEAR::isError($req->sendRequest())) {
　　　exit('通信エラーが発生しました');
}
$code = $req->getResponseCode();
if ($code == 200) {
　　　print "ブックマークの編集に成功しました";
}
else {
　　　print "エラーが発生しました：コード = ${code}\n";
}
?>
--------------------------------------------------------------------------------

このプログラムでは、7行目と8行目によって、「http：//b.hatena.ne.jp/atom/edit/ページのID」にPUTプロトコルでアクセスするようにしています。

このプログラムを実行した後、はてなブックマークにログインして、編集後のブックマークを見てみると、コメントが変わっていることが分かります（図3）。

今回のまとめ

ここまでで見てきたように、はてなブックマークでは、AtomAPIで通信するプログラムを作ることによって、ブックマークの追加や編集を行うことができます。

今回は、プログラム言語としてPHPを使いました。しかし、PHPだけでなく、ほかの言語ではてなブックマークにアクセスしてブックマークを操作することもできます。例えば、Visual BasicやVisual C++を使って、はてなブックマークを操作するためのWindows用のデスクトップ・アプリケーションを作る、といったことも可能です。

また、今回はスタンド・アローンのプログラムを作りましたが、既存のシステム用にブックマーク操作を行う拡張機能を作ることも考えられます。例えば、ブログに記事を投稿すると同時に、その記事を自動的にブックマークする、といった拡張機能を作ることが考えられます。

このように、RESTで操作できるWebサービスは、ほかのプログラムとの連携によって、さまざまな使い方をすることができます。

前回（第2回）と今回（第3回）は、Webサービスにアクセスする方法を紹介しました。最終回の次回（第4回）では、Webサービスを作る例を紹介します。

【参考文献】
『RESTful Webサービス』（Leonard Richardson、Sam Ruby著、山本陽平監修、株式会社クイープ翻訳、オライリー・ジャパン発行、発行年：2007）