API Method: GET recent messages

Retrieves a list of recent messages of the room.

Path:

/api/v2/rooms/#{room_id}/messages.#{format}

Formats:

xml, json

HTTP Method(s):

GET

Parameters:

• page Optional. Specifies the page of results to retrieve. Pagination starts from page 1 (by default).
• per_page Optional. Specifies the number of messages to retrieve. Default value is 20. May not be greater than 200.

Usage examples:

$ curl -u api_token:x https://bigbang.jaconda.im/api/v2/rooms/developers/messages.xml?per_page=4

Response:

XML example:

<?xml version="1.0" encoding="UTF-8"?>
<messages>
  <message>
    <created-at type="datetime">2010-02-15T11:48:04Z</created-at>
    <id type="integer">528990</id>
    <sender-id>dow.jones@gmail.com</sender-id>
    <kind>chat</kind>
    <sender-name>Dow Jones</sender-name>
    <text>I don't feel very good today :(</text>
    <updated-at type="datetime">2010-02-15T11:48:04Z</updated-at>
  </message>
  <message>
    <created-at type="datetime">2010-02-15T11:48:22Z</created-at>
    <id type="integer">528991</id>
    <sender-id>nasdaq@gmail.com</sender-id>
    <kind>chat</kind>
    <sender-name>Nasdaq</sender-name>
    <text>You know, me too...</text>
    <updated-at type="datetime">2010-02-15T11:48:22Z</updated-at>
  </message>
  <message>
    <created-at type="datetime">2010-02-15T11:48:49Z</created-at>
    <id type="integer">528992</id>
    <sender-id>nikkei@gmail.com</sender-id>
    <kind>chat</kind>
    <sender-name>Nikkei</sender-name>
    <text>What's wrong my friends?</text>
    <updated-at type="datetime">2010-02-15T11:48:49Z</updated-at>
  </message>
  <message>
    <created-at type="datetime">2010-02-15T11:49:09Z</created-at>
    <id type="integer">528993</id>
    <sender-id>client@gmail.com</sender-id>
    <kind>chat</kind>
    <sender-name>Anton Mironov</sender-name>
    <text>Cheer up guys! It's gonna be fine</text>
    <updated-at type="datetime">2010-02-15T11:49:09Z</updated-at>
  </message>
</messages>