Bibliographic Deep Linking

This service represents a bibilographic view of the items within a collection. This is designed as a deep link service for human interaction. The goal is to take the user as close as possible to the relevant content using the collection's own services. The directory is used to look up services supporting the supplied parameters that may be used to search or access the collection. If no appropriate services are found the request is redirected to the closest URL determined by information held about the collection in the directory. The order of search is:

1. An appropriate service associated with the collection in the directory
2. The homepage of a service associated with the collection in the directory
3. The base URL of a service associated with the collection in the directory
4. The homepage of the collection
5. The directory entry for the collection
6. The home page of the directory

Service URI

http://api.talis.com/1/node/items/{collection_id}/bib

Path segments:

• collection_id – the collection’s identifier as specified in the directory

GET

Performs a simple bibliographic search on the collection and returns results in the collection’s default format

Required parameters

• api_key – the user’s API key

Optional parameters

• title – a series of words that all must match within the title of the item
• author – a series of words that all must match within the author of the item
• isbn – the isbn of the item

Typical HTTP Responses

• 203 – the request was successful, the descriptions are returned in the response
• 302 – the request was successful but the descriptions are to be found at the specified location
• 400 – the request failed because required parameters were not supplied
• 502 – the request failed because the Talis service cannot determine how the to access the collection with the supplied parameters