http://ameblo.jp/amebabbs-api/ アメばた会議のAPIについて説明をします。 ja-jp http://ameblo.jp/amebabbs-api/entry-10097315989.html 本ドキュメントは、アメばた会議 掲示板サービス（以下 アメばた と呼称）において提供するAPI機能の仕様について記載するものとなります。

]]> 2008-03-10T18:00:00+09:00 http://ameblo.jp/amebabbs-api/entry-10097316368.html アメばたでは、以下のAPIを提供しています。 スレッド レス 作成したスレッド レスしたスレッド フリーワード検索 盛り上がっているスレッド キーワード 2008-03-10T17:50:00+09:00 http://ameblo.jp/amebabbs-api/entry-10097317130.html アメばたの提供するAPIはRESTfulなAPIとなっており、情報へのアクセスは各APIのURLに対しHTTPの各種メソッド（GET、POST、PUT、DELETE）を送信することで行います。 RESTについては以下のサイトなどをご参照ください。 http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm 以下、接続例として、 スレッドAPIに対してGET 2008-03-10T17:40:00+09:00 http://ameblo.jp/amebabbs-api/entry-10097317477.html アメばた API で採用している文字コードはUTF-8 になります。 API へのリクエストの際に使用する文字コード、ならびにAPI から返却されるデータの文字コード、ともにUTF-8 での送受信を行います。 API リクエストの際に、URI にクエリーストリングとして日本語などダブルバイト文字列を付加したい場合は、UTF-8 の文字列をURL エンコーディングした値を渡すようにしてください。 例：アメばた会議 ⇒%E3%82%A2%E3%83 2008-03-10T17:30:00+09:00 http://ameblo.jp/amebabbs-api/entry-10097321972.html アメばたAPI から返却されるデータのフォーマットはRSS形式、XML形式、もしくはJSONP形式になります。 RSSはRSS2.0に準拠しています。 XMLならびにJSONPのデータ項目はアメばた独自のものとなります。 2008-03-10T17:20:00+09:00 http://ameblo.jp/amebabbs-api/entry-10097322688.html 本人性の確認が必要なAPIの操作を行う場合は、アメばたシステムの個人認証を通過する必要があります。 アメばたでは、WSSE認証により、本人性の確認を行います。 WSSE認証では、URIへのリクエストの際に HTTPのリクエストヘッダ中に「X-WSSE」ヘッダを付与することで リクエスト元のアイデンティティ情報を送信します。 X-WSSEのフォーマットは以下のようになります。（※改行は含まれません。すべて一行で記載） 2008-03-10T17:10:00+09:00 http://ameblo.jp/amebabbs-api/entry-10098478128.html 以下のように、 各APIのアドレスをブラウザで表示することで、データフォーマットの確認をすることができます。 （下記はスレッドAPI のアドレスになります） RSS2.0 http://api.amebabbs.ameba.jp/rss/thread/thread XML http://api 2008-03-10T16:30:00+09:00 http://ameblo.jp/amebabbs-api/entry-10098499221.html POST/PUT/DELETEメソッドにて リソースのデータ更新を行う際は リクエストボディにXMLのデータを含めて送信をしてください。 例：スレッド作成時 POST /xml/thread/thread HTTP/1.1 X-WSSE: UsernameToken Username="test", PasswordDigest="test", Nonce="test", Created="2008 2008-03-10T16:05:00+09:00 http://ameblo.jp/amebabbs-api/entry-10098900268.html アメばたで提供するAPIから返却されるHTTPレスポンスは 以下の内容に基づいて返却されます。 APIを使用したアプリケーションでのエラーハンドリングの際にご参考ください。 ステータスコード 意味 振る舞い 200 OK 正常 201 Created 新規リソースが追加された。アメばたではスレッドのPOSTの際のみ返却。 401 Unauthorized 本人性の確認が必要なリソースへのアクセス時にユーザ認証に失敗した場合返却。 403 F 2008-03-10T16:00:00+09:00 http://ameblo.jp/amebabbs-api/entry-10098478621.html 概要 スレッドの一覧情報の取得、ならびにスレッド作成・変更・削除を行うAPIです URL http://api.amebabbs.ameba.jp/rss/thread/thread http://api.amebabbs.ameba.jp/xml/thread/thread http://api.amebabbs.ameba.jp/jsonp/thread/thread JSONPコールバック関数名 th 2008-03-10T15:55:00+09:00