API Method: POST message

Broadcasts a new message in the room.

URL:

https://jaconda.im/api/rooms/#{room_id}/messages.#{format}

Formats:

xml, json

HTTP Method(s):

POST

Parameters:

Note that all parameters are encapsulated within a message array (see example)

• text Required. The text of the message you are broadcasting. The value of the must pass xhtml validation. Allowed tags are: a, br, em, b, i, span. All other tags will be removed. Don't forget to escape special characters.

Usage examples:

cURL:

$ curl -u api_token:x -d "message[text]=Hello" https://jaconda.im/api/rooms/1/messages.xml

Response:

XML example:

<?xml version="1.0" encoding="UTF-8"?>
<message>
  <created-at type="datetime">2010-02-23T07:51:36Z</created-at>
  <id type="integer">566441</id>
  <jid>127.0.0.1</jid>
  <kind>broadcast</kind>
  <name>api</name>
  <room-id type="integer">1</room-id>
  <text>Hello</text>
  <updated-at type="datetime">2010-02-23T07:51:36Z</updated-at>
</message>