B.18.3 Client Examples

Here are some examples of URLs which can be retrieved from a server which is running at the base URL http://localhost:2112/stilts/. All these use the HTTP GET form of request; the POST form could be used instead with the same effect.

http://localhost:2112/stilts/

Returns an HTML page giving version information and some links to example usages of the server.

http://localhost:2112/stilts/task/tpipe

Returns an HTML page giving usage instructions for the tpipe task.

http://localhost:2112/stilts/task/calc?expression=21%2b2

Invokes the calc task to return a document containing the text "23". Note that the plus ("+") sign in the expression has to be encoded using the sequence "%2b" since "+" has a special significance in query URLs - see for instance sec 2.2 of RFC 1738.

http://localhost:2112/stilts/task/plot2d?in=/data/table1.vot&xdata=RMAG&ydata=BMAG

Invokes the plot2d task to return a magnitude-magnitude diagram of the named local file as an image (probably an image/png).

http://localhost:2112/stilts/task/tcopy?in=/data/cat.fits&ofmt=votable

Invokes the tcopy task to return a translation of the named local FITS file to VOTable format.