Jaiku API 仕様書 (勝手に日本語訳シリーズ)

☆

Twitter に続き、「Jaiku API 仕様書」の勝手訳を用意してみました。 Jaiku の API 仕様書には間違い(たぶん、当初はその方向で実装するつもりだったんだけど、実際は違う実装になってしまった、という流れではないかと推測。そして、ドキュメントは修正されないまま放置)があり、はまっている人をちらほら見かけましたので、その辺をきっちり書いたものを作ってみました。ですので、勝手訳というよりは、勝手解説書のようなものになっています。

• Jaiku API 仕様書 (日本語訳) 参考資料付き

以下、どの辺が罠になっているか、簡単に書いておきます。

JSON 版の投稿API

POST /json
user=jaiku&personal_key=12345678901234&method=test&echo=Hello

Jaiku | Documentation

method は JSONP でいうところの function 名に相当するのもの(つまり、任意の名前を指定可能)かと思いきや、実は、XML-RPC API の method call で指定する RPC の名前を指定する必要があります。つまり、method=presence.send ですね。さらに、echo というのは間違いで、message を使います。message=投稿内容 ってな感じで指定します。

そして、レスポンス。単に

{"status":"ok"}

が返ってくるだけです。リクエストのパラメータが間違っていても、このステータス OK が返ってきたりします。結構、いい加減。

XML-RPC API版

こっちも問題ありまくり。仕様書通りにリクエストを組み立てて送信すると、以下のようなエラーが返ってきます。

Dealing with some load, our apologies, we're feverishly working on it.

あるいは

Argument #2 is not an array in content.module on line xxx

というエラーが返ってきたり。

実際、はまっている人が続出、続出、続出しまくり。結局、解決のヒントはコメント欄にありました。このコメント欄の mastermaq さんの最後のコメントに書いてある XML をちょっといじれば、解決できます。username を user にするだけ。

ってな感じで、何とか JSON でも XML-RPC API でも投稿できるようになったので、Jaiku クライアントを作ってみました。

Jaiku クライアントの話はまた別の記事に書きます。