room.getArchives

room.getArchives

オリジナル: http://wiki.lingr.com/dev/show/RoomGetArchives

翻訳日: 2007/04/18

原文リビジョン: 1


チャットルームにアーカイブされた発言を取得します。1分に1回以上呼び出してはいけません。

HTTPメソッド

GET

パラメータ

api_key(必須)

あなたのAPIキー

id(必須)

対象のルームのID

year, month, day(オプション)

発言を取得したい日時を指定します。タイムゾーンはそのルームの設定のものが使われます。値を指定する場合は年月日すべてを指定してください。指定されない場合は、直近の200メッセージが返されます。

user_messages_only(オプション)

trueを指定した場合、ユーザによるメッセージのみを返します。つまり、システムメッセージは返されません。trueが指定されない場合はユーザメッセージシステムメッセージの両方を返します。デフォルト値はfalseです。

password(オプション)

ルームのパスワードを指定します。

format(オプション)

希望の応答フォーマット。指定する場合はxmljsonを指定します。デフォルトxmlです。

callback(オプション)

応答フォーマットjsonを指定した場合、コールバック関数名を指定します。


認証

このメソッドは認証を必要としません。

応答の例

<?xml version='1.0' encoding='UTF-8'?>
<response>
  <status>ok</status>
  <room>
    <id>gcnZ3vAcZDA</id>
    <name>My awesome room</name>
    <description>A really GREAT room</description>
    <url>http://www.lingr.com/room/myawesomeroom</url>
    <icon_url>http://images.lingr.com/room/gcnZ3vAcZDA/16x16.gif</icon_url>
    <counter>356</counter>
    <max_user_message_id>346</max_user_message_id>
    <tags/>
  </room>
  <messages>
    <message>
      <id>235</id>
      <type>user</type>
      <occupant_id>3tUud4Upiev</occupant_id>
      <nickname>safari</nickname>
      <source>browser</source>
      <client_type>human</client_type>
      <icon_url>http://images.lingr.com/user/0/26x26.gif</icon_url>
      <timestamp>2007-01-11T07:17:04-08:00</timestamp>
      <text>hello</text>
    </message>
  </messages>
</response>

応答の詳細

成功したメソッド呼び出しの応答は以下のような要素を持ちます。

room

このルームの情報です。構造は次のページを参照してください。→Room

messages

ルーム中のメッセージを格納した配列が返ります。それぞれの構造は次のページを参照してください。→Message


エラーコード

100: 不正HTTPメソッド

HTTPメソッドが間違っています。

101: 無効なAPIキー

指定されたAPIキーが不正です。

104: 不正な応答フォーマット

要求された応答フォーマットサポートされていません。

108: 無効なルームID

与えられたルームIDは無効です。

112: 回数制限に達した

ポーリングの頻度が制限以上です。

116: 無効なパスワード

与えられたルームのパスワードは無効です。

117: パスワードが必要です

このルームにはパスワードがかかっていますが、passwordパラメータが与えられませんでした。

120: 不正文字コードエンコーディング

あなたが入力したデータUTF-8として不正エンコーディングを含んでいます。

詳細は「APIの基礎について学ぶ」を参照してください。

128: 不正パラメータ

年月日の値のいずれか、もしくは全てが不正か欠けています。