Directory Services

Directory Services

Represents the collection of service descriptions maintained by the directory.

Service URI

http://api.talis.com/1/dir/services

GET

Returns an extended RDF description of the specified services ordered by the service URIs. This differs from the Directory Resources service by returning an extended RDF description of the specified resources, including descriptions of related resources. Refer to the directory data model documentation for an explanation of the RDF used by the directory.

Required Parameters

  • api_key – the user’s API key

Optional Parameters

  • uri – describe service with this URI
  • search – describe services whose titles and descriptions contain these search terms
  • group – a space delimited list of group URIs. The list of descriptions will be restricted to those services that are members of this group.
  • xsl – the URL of an XSL stylesheet to apply to the output

Typical HTTP Responses

  • 200 – the request was successful, the descriptions are returned in the response
  • 403 – the request failed because the api_key was invalid
  • 500 – the request failed due to an internal server error

Sample Output

<?xml version="1.0"?>
<rdf:RDF
    xmlns:dctype="http://purl.org/dc/dcmitype/"
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:ddd="http://schemas.talis.com/2005/ddd/db#"
    xmlns:sv="http://schemas.talis.com/2005/service/schema#"
    xmlns:dc="http://purl.org/dc/elements/1.1/">

  <dctype:Service rdf:about="http://directory.talis.com/res/dddconv-rlg1519-svc#self">
    <sv:interactionSet rdf:resource="http://directory.talis.com/res/dddconv-isvoyager#self"/>
    <sv:baseUri>http://catalogue.lib.ed.ac.uk/cgi-bin/Pwebrecon.cgi</sv:baseUri>
    <dc:title>Moray House Institute of Education Collection OPAC</dc:title>
  </dctype:Service>

  <dctype:Service rdf:about="http://directory.talis.com/res/dddconv-id153245#self">
    <sv:interactionSet rdf:resource="http://directory.talis.com/res/dddconv-istrans-taliswebopac#self"/>
    <sv:baseUri>http://opac.moray.gov.uk/www-bin/www_talis32</sv:baseUri>
    <ddd:transformClass>DeepDiveDirectory.Transformers.TalisWebOpac</ddd:transformClass>
    <dc:title>Moray Council Collection OPAC</dc:title>
  </dctype:Service>

</rdf:RDF>