[トップページ]
Geohist では REST のインターフェースを準備し、ユーザの書いたメッセージなどを取得できるようにしています。
user_messages はユーザの書いたメッセージを取得したり書き込むためのインターフェースです。
ユーザ名を指定して、そのユーザまたはそのユーザが友達登録している人のメッセージを表示します。
http://geohist.net/user_messages/find_by_username/[username].xml?with_follow=[true|false]
[username] のところに取得したいユーザ名を指定してください。
設定できる引数は下記のようになります。
以下にAPIの利用例のURLを書きます。
返されるメッセージには、下記のようなXMLになります。
<user_messages_response>
<requests> <!-- リクエストの内容 -->
<num>10</num> <!-- 出力するメッセージの数 -->
<page>10</page> <!-- 出力するメッセージのページ番号 -->
<with_follow>10</with_follow> <!-- 友達のメッセージも表示するかどうか -->
</requests>
<status> <!-- レスポンスの状態 -->
<has_next_page>true</has_next_page> <!-- 次のページがあるかどうか -->
</status>
<messages> <!-- メッセージのリスト -->
<message> <!-- メッセージ -->
<message>ほげほげ</message> <!-- メッセージ本文 -->
<location_lat>35.0000000</location_lat> <!-- 北緯 -->
<location_lon>135.0000000</location_lon> <!-- 東経 -->
<created_at>2008-05-23T13:02:26+09:00</created_at> <!-- 作成日時 -->
<updated_at>2008-05-23T13:02:26+09:00</updated_at> <!-- 更新日時 -->
<id>260</id> <!-- メッセージのシリアル番号 -->
</message>
</messages>
</user_messages_response>
メッセージを書き込むためのインターフェースです。
下記のパラメータを GET メソッドで送信してください。
http://geohist.net/user_messages/create_message/[username].xml?[params]
users インターフェースでは、おもにユーザ認証を行うためのインターフェースです。