Two new web services
I’ve implemented two example web services to demonstrate the Incutio PHP XML-RPC library’s capabilities. The services allow you to search and retrieve articles from FOLDOC and the Jargon File, two popular freely available online dictionaries.
The Jargon File
The Jargon File is “a comprehensive compendium of hacker slang illuminating many aspects of hackish tradition, folklore, and humor”.
It is currently edited by Eric Raymond, and can be found on the web at http://www.tuxedo.org/~esr/jargon/
The web service interface to the Jargon File allows you to search the dictionary and retrieve entries from it.
Server: scripts.incutio.com Path: /xmlrpc/services/jargonfile.php Port: 80
The following methods are available (in addition to the standard system methods):
- Returns a string containing information about the Jargon File and the web service interface.
- Accepts a string (the search term) and returns an array of shortnames for entries that contain the term.
- Accepts a string (the shortname), and returns a struct representing the entry with that shortname.
- Accepts a string (the title), and returns a struct representing the entry with that title.
I have written a guide to accessing the Jargon File web service using Python’s
FOLDOC is the Free Online Dictionary of Computing, edited by Denis Howe and made available under the GNU Free Documentation License. It can be found on the web at www.foldoc.org.
Server: scripts.incutio.com Path: /xmlrpc/foldoc/server.php Port: 80
- Returns a string containing information about FOLDOC and the web service interface.
- Accepts a string (the search term) and returns an array of names of entries containing that term (up to a limit of 1000).
- Accepts a string (the name of an entry) and returns a struct representing that entry.
- Returns a struct with a list of all of the categories in the dictionary along with the number of entries in each category.
- Accepts a string (the category) and returns an array of entry titles that belong to the category.