The API is comprised of five request types:
Responses from the API can be returned in eight different format:
In addition to the basic request protocol the services also can be access via the following alternative request formats:
ISBNs are related to each other in WorldCat using an algorithm developed by OCLC Research. The algorithm restructures WorldCat bibliographic records to conform to the FRBR conceptual model for information objects. For instance, rather than requiring an end user to traverse multiple records that represent many different manifestations of a book—including printings, hardback or paperback editions or even filmed versions—"FRBRized" WorldCat information allows that user to review a core record that lists all manifestations.
The xISBN Web service queries database tables in WorldCat created by the FRBR algorithm.
You are encouraged to obtain a Worldcat Affiliate ID before using the service. An affiliate ID can be used to track usage of your application. To provide an affiliate ID in request, simply add "&ai=[affiliate ID]", such as:
Affiliate ID based usage track is a free service. You can check affiliate ID based usage from xISBN admin page.
Commercial and heavy usage users could obtain an access token. To provide a token in request, add "&token=[token]&hash=[hashvalue]". The hash value is calculated per request, such as:
The hash is calculated this way:
e.g. If you request ip address is "126.96.36.199", your token is "mytoken", and your secret is "mysecret", and you are requesting http://xisbn.worldcat.org/webservices/xid/isbn/0596002815?method=getEditions&format=xml, the md5 hash will be calculate like:
And you complete request will be
At server end we will re-run the hash algorithm and compare hash value. You can maintain access token from xISBN account page.
Commercial and heavy usage users could also use IP address-controlled access. IP address-controlled access does not require any parameter in xISBN request, you can maintain IP address-controlled access from xid account page. It's mandatory to put affiliate ID in request if you choose to use IP address-controlled access.
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