The XML-RPC interface

In the documentation below, hostport refers to the machine and port number hosting the Quaestor service, such as localhost:8080.

The XML-RPC endpoint is http://hostport/quaestor/xmlrpc

Methods

There are only two methods defined at present; more might appear in future.

get-model(knowledgebase:string [,submodel:string]) : URL
Retrieve a URL from which the client can obtain the full knowledgebase, or just a submodel. This is just a convenience method, since the URL returned is just the one described in the HTTP-interface above.
query-model(knowledgebase:string, sparql-query:string [,mime-type:string]) : URL
Sends a SPARQL query to the server, and return a URL from which the results can be retrieved. Although this returns promptly, after having done all required checking and parsing, the query is not actually run until the returned URL is dereferenced.

XML-RPC fault codes

0
Protocol error, such as mangled XML, or invalid request headers
1
Unrecognised method
2
Malformed request: the method was syntactically valid and intelligible, but had the wrong number or type of arguments
10
get-model, query-model: Unknown object requested, either an invalid knowledgebase or submodel
20
query-model: bad query, either unparseable SPARQL or an unsupported MIME type