del.icio.us API の Error response について

del.icio.us API は request URL (正確にはアドレスの /api/ 以降、? より以前) が method で、query（アドレスの ? 以降、無い場合もある）が argument となる。かえってくるのは method によって変わる“野良”XML を返してくれる訳です。

いま、PHP の class を作ってやろうと思っているんですが、(pear もメンテされてないみたいだったから）、エラー対応をしようと思ってるんだけど、サイトにエラーに関する記述が何も無い。

例えば、tags/rename は old と new という query を必要としますが、何も request しないと…

<?xml version='1.0' standalone='yes'?>
<result>something went wrong</result>

がかえってきます。

でも、例えば、posts/add に query なしでアクセスすると…

<?xml version='1.0' standalone='yes'?>
<result code="something went wrong" />

なんでやねん。

野良 XML はいいと思うんだ。JSON でもいいけど、どっちかというと XML の方が、処理コストは高くても、data exchange format としては枯れてるし、いろんな処理系で使えるし。でもこの仕様は使いにくい…で、思いついたのは…

ステータス200なのに「その商品はありません」

で語られてるみたいに、HTTP-STATUS で返してくれると、さらに便利なのにな、と。後で、Delicious mailing list に投げてみます。

でもさ、他の API はどうなんだろう？？後で実験してみよう。