Directory Resources

Directory Resources

Represents the collection of resource descriptions maintained by the directory

Service URI

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

GET

Returns simple RDF descriptions of the specified resources ordered by the resource URI. 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 resource with this URI
  • group – a space delimited list of group URIs. The list of descriptions will be restricted to those resources 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:ad="http://schemas.talis.com/2005/address/schema#"
    xmlns:foaf="http://xmlns.com/foaf/0.1/"
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:dir="http://schemas.talis.com/2005/dir/schema#"
    xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#"
    xmlns:dc="http://purl.org/dc/elements/1.1/"
    xmlns:lib="http://schemas.talis.com/2005/library/schema#">
  <lib:Library rdf:about="http://directory.talis.com/res/pap060331-215#self">
    <dir:etag>7b47c1c9-dc86-4073-8e09-5764806706ff</dir:etag>
    <foaf:mbox rdf:resource="mailto:oioc-enquiries@bl.uk"/>
    <ad:streetAddress>96 Euston Road</ad:streetAddress>
    <geo:lat>51.529392</geo:lat>
    <foaf:homepage rdf:resource="http://www.bl.uk/"/>
    <dc:title>British Library at St. Pancras</dc:title>
    <geo:long>-0.127888</geo:long>
    <ad:postalCode>NW1 2DB</ad:postalCode>
    <ad:countryName>England</ad:countryName>
    <ad:localityName>London</ad:localityName>
    <ad:fax>020 7412 7641</ad:fax>
    <ad:tel>020 7412 7873</ad:tel>
  </lib:Library>
</rdf:RDF>