API Method: GET messages

Retrieves a list of messages in the specified room.

URL:

https://jaconda.im/api/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:

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

Response:

XML example:

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