RaccXML

On top of the raccdoc protocol is the utility raccxml; this program speaks raccdoc, but returns its results in a stateless XML document, perfect for integrating into an application which understands XML. Because of XMLHttpRequest restrictions in FireFox, you need to install this program on your webserver. Note that raccxml could have been written by anyone and installed anywhere – it doesn't need anything installed on ISCA's server.

Currently, all GET commands are executed before any POST commands. That is likely to change in the future.

Because of ISCA's heavyweight footprint (compared to standalone implementations of the raccoon server), using raccxml to talk directly to ISCA's raccdoc server is not recommended. Instead, it should go through a helper program which maintains the raccoon connection between stateless HTTP requests. This step is vital for working with the x-message sub-system.

Sample Usage

Get a list of all topics on ISCA:
   https://jalot.com/raccxml.cgi?db=isca&listtopics=all
Get a list of all notes in this forum:
   https://jalot.com/raccxml.cgi?db=isca&listnotes=49/last150
Read the most recent note:
   https://jalot.com/raccxml.cgi?db=isca&readnotes=49/last1
——————–

Global commands

 db=dbname
 user=handle[/pin]
 topic=topicid or topicname (default topic)
 password=password          (in POST, not GET)

GET commands

 listtopics=type (type=unread,todo,joined,all)
 listnotes=[topic/]unreadNN[,topic/unreadNN[,topic/unreadNN...]]
 listnotes=[topic/]lastNN[,topic/lastNN[,topic/lastNN...]]
 listnotes=[topic/]first:last,topic/lastNN[,topic/lastNN...]]
 readnotes=[topic/]unreadNN[,topic/unreadNN[,topic/unreadNN...]]
 readnotes=[topic/]lastNN[,topic/lastNN[,topic/lastNN...]]
 readnotes=[topic/]info
 readnotes=[topic/]first:last,topic/lastNN[,topic/lastNN...]]
 profile=user
 // On ISCA, "channel" is always set to "default" (ISCA has no chat rooms)
 xget=channel
 xsend=[channel:]user
 xonline=channel
 xremove=channel

POST commands

 setrc=topic/value[,topic/value ...]
 setrc=auto (update userrc as readnotes download notes)
 postbody=body
 xmsgbody=message
 
http_xml.txt · Last modified: 2009/09/16 15:31 (external edit)
 
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki