OCLC Developer Network

Details Functionality

Details Functionality

The Details functionality retrieves information from the WorldCat Registry profile for an individual institution or consortium. The record retrieved is based on a unique, persistent identifier passed as a parameter. Accepted identifiers include the following:

  • WorldCat Institution Identifier assigned by the WorldCat Registry
  • OCLC Symbol

The Detail has to possible services:

  • content - returns a record contain basic public metadata that that would normally be available to an unauthenticated user who conducts a search on the WorldCat Registry Web site.
  • enhancedContent - returns a record containing all public metadata that would normally be available to an unauthenticated user who conducts a search on the WorldCat Registry Web site.

Syntax

The basic SRU usage of the Web service is as follows:

<Web Service SRU Base URL> <Service Label> "/Institutions/" <Institution identifier>

Where:

<Web Service SRU Base URL>
=
http://www.worldcat.org/webservices/registry/
<Service Label>
=Service label - content or enhancedContent
<Institution identifier>
=Alphanumeric institution identifier

Syntax for lookup based on OCLC symbol is as follows:

<Web Service OCLC Lookup Base URL> "/" <OCLC Symbol> "?serviceLabel=<Service Label>"

Where:

<Web Service OCLC Lookup Base URL>
=
http://www.worldcat.org/webservices/registry/lookup/Institutions/oclcSymbol/
<OCLC Symbol>
=Alphanumeric OCLC Symbol
<Service Label>
=Service label content or enhancedContent

Usage Examples

This URL provides an example of the WorldCat Registry Detail Web service that retrieves details about Ohio University's Alden Library, which has the persistent WorldCat Institution ID "2320," using an SRU protocol. It returns HTML to a Web browser and XML to software agents.

http://www.worldcat.org/webservices/registry/content/Institutions/2320
	

http://www.worldcat.org/webservices/registry/enhancedContent/Institutions/2320

This URL provides an example of the service that retrieves details of the same institution, pulling XML directly using the library's OCLC symbol.

http://www.worldcat.org/webservices/registry/lookup/Institutions/oclcSymbol/OUN?serviceLabel=content

http://www.worldcat.org/webservices/registry/lookup/Institutions/oclcSymbol/OUN?serviceLabel=enhancedContent

Follow the OCLC Developer Network:

The OCLC Developer Network supports the use of OCLC Web Services—a set of tools and APIs that expose data and services for WorldCat and our member libraries and partner institutions or companies. learn more »

© 2010 OCLC Domestic and international trademarks and/or service marks of OCLC Online Computer Library Center, Inc. and its affiliates


Powered by Drupal, an open source content management system