Directory Collections

Represents the collection of collection descriptions maintained by the directory

Service URI

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

GET

Returns an extended RDF description of the specified collections. 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 collection with this URI
• search – describe collections whose titles and descriptions contain these search terms
• identifier – a space delimited list of collection identifiers. The list of descriptions will be restricted to collections with those identifiers.
• group – a space delimited list of group URIs. The list of descriptions will be restricted to those collections 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:dctype="http://purl.org/dc/dcmitype/"
    xmlns:foaf="http://xmlns.com/foaf/0.1/"
    xmlns:dct="http://purl.org/dc/terms/"
    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/">
  <dctype:Collection rdf:about="http://directory.talis.com/res/pap060331-1544coll#self">
    <foaf:homepage rdf:resource="http://www.shef.ac.uk/nfa/"/>
    <dir:isAccessedVia rdf:resource="http://directory.talis.com/res/pap060331-1542#self"/>
    <dir:etag>f6749edd-7b79-4f9d-8e35-38d3737feae2</dir:etag>
    <dct:abstract>
      A unique collection of photographic, printed, manuscript and audiovisual 
      material covering all aspects of the culture of travelling showpeople, their
      organisation as a community, their social history and everyday life; and
      the artefacts and machinery of fairgrounds.
    </dct:abstract>
    <dc:title>National Fairground Archive</dc:title>
    <dc:identifier>ad418.sw</dc:identifier>
    <dc:coverage>
      There are now over 80,000 images in the photographic collection, in 
      addition to audio and video material, journals and magazines, and 
      nearly 3,000 monographs. The collection also includes a unique body 
      of fairground ephemera (programmes, handbills, posters, charters and 
      proclamations, plans and drawings).
    </dc:coverage>
  </dctype:Collection>
</rdf:RDF>