もごもごAPI

もごもごAPI、マッシュアップコンテスト結果はこちら

もごもごAPI(α版)とは

もごもごAPIとは、他のプログラムからもごもごにアクセスするための外部プログラムインターフェースです。
サービスに影響の出るレベルの過剰なアクセスは制限させていただく場合があります。 また、もごもごAPIは開発段階であり、予告なく仕様が変更される場合がありますので予めご了承ください

ご利用にあたって

もごもごAPIをご利用頂く場合は、もごもごAPI利用規約にご同意頂いたと見なさせていただきます。

API認証について

・APIには認証が必要になります
・認証はBasic認証で行ないます
・ユーザ名にはご登録いただいているメールアドレスをご入力ください。
・APIパスワードの設定はログイン後にセッティングメニューにて設定が可能です。
・本APIを利用したアプリケーションを提供する際は、利用ユーザーに対しAPIパスワードを新たに登録して頂くよう告知してください。
・APIパスワードは、【必ず】もごもごの本パスワードとは異なるパスワードを設定してください。

取得形式

・XML形式
・JSON形式

ステータス関連のAPI

みんなの広場(public_timeline)

URL：http://api.mogo2.jp/statuses/public_timeline.xml（もしくは .json）

機能：みんなの広場の最新ステータス(発言)を取得する (20件)
引数：since_id=ステータスID (オプション)　　指定したID以降のステータスのみ取得する


例：http://api.mogo2.jp/statuses/public_timeline.xml?since_id=21

レススレッド(thread_timeline)

URL：http://api.mogo2.jp/statuses/thread_timeline/ステータス(発言)ID.xml（もしくは .json）

機能：指定したステータス(発言)とその発言に対するレススレッドを取得する (親発言1件＋レススレッド20件)
引数：since=日時 (オプション)・・・指定した日時以降に更新されたをレススレッドを取得する。日時のフォーマットは RFC822(の「5. 日付と時刻仕様」 = RFC2822 の 3.) に従う。


例：http://api.mogo2.jp/statuses/thread_timeline/53.xml

自分と友達のもごもご(friends_timeline)

URL：http://api.mogo2.jp/statuses/friends_timeline.xml
もしくは、
URL：http://api.mogo2.jp/statuses/friends_timeline/指定ユーザーID.xml（もしくは .json）

機能：自分と友達の最新ステータス(発言)、もしくは指定したユーザーとその友達の発言を取得する (20件)
引数：count=件数 (オプション)・・・指定した件数分、ステータスを取得（最大20件。countオプションを指定しない場合は20件）
　　　since=日時 (オプション)・・・指定した日時以降に update されたステータスを取得する。日時のフォーマットは RFC822(の「5. 日付と時刻仕様」 = RFC2822 の 3.) に従う。


例：http://api.mogo2.jp/statuses/friends_timeline.xml?since=Tue%2C+27+Mar+2007+22%3A55%3A48+GMT
例：http://api.mogo2.jp/statuses/friends_timeline/21.xml?since=Tue%2C+27+Mar+2007+22%3A55%3A48+GMT
　　2007年3月27日22時55分48秒GMT以降に update されたステータスを XML 形式で取得する

指定したユーザーのもごもご(user_timeline)

URL：http://api.mogo2.jp/statuses/user_timeline.xml（もしくは .json）
もしくは、
URL：http://api.mogo2.jp/statuses/user_timeline/指定ユーザーID.xml（もしくは .json）

機能：自分の発言もしくは、ID指定したユーザーの発言を取得
引数：count=件数 (オプション)・・・指定した件数分、ステータスを取得（最大20件。countオプションを指定しない場合は20件）
　　　since=日時 (オプション)・・・指定した日時以降に update されたステータスを取得する。日時のフォーマットは RFC822(の「5. 日付と時刻仕様」) に従う


例：http://api.mogo2.jp/statuses/user_timeline.xml?count=5&since=Tue%2C+27+Mar+2007+22%3A55%3A48+GMT
例：http://api.mogo2.jp/statuses/user_timeline/21.xml?count=5&since=Tue%2C+27+Mar+2007+22%3A55%3A48+GMT


ＵＰＤＡＴＥ

URL：http://api.mogo2.jp/statuses/update.xml（もしくは .json）

機能：自分のステータス(発言、投稿内容)を更新(update)する。引数 status は必須。投稿に成功したら、自分が投稿した内容のステータスが返却されます（POST推奨）
引数：status=ステータス(発言、投稿内容)・・・必ず URL エンコードすること。140文字以下におさめてください。また、投稿時はUTF-8 をお使いください。


JSONのコールバック関数について

JSON形式利用の際、パラメータ「callback」を付与すると、コールバック関数の指定が可能です。
※コールバック関数に指定できる文字は [A-Za-z0-9_\.\[\]] のみとなります(不正な文字が含まれている場合、コールバック関数指定なしの呼び出しと同じ)。