These are the types of errors that occur when you fail to appropriately authenticate using your WSKey. For most of our web services when you fail to authenticate appropriately you will receive an HTTP 401 status. There are several variations on this issue:
These are the types of errors that occur when a web service requires a valid user with the appropriate roles and permissions and either:
You will receive an HTTP 403 status when the user is invalid or does not have the appropriate roles and permissions
The HTTP method you are trying to use is not supported by the web service. Not all web services support all HTTP methods. Some web services are read-only. Some objects cannot be deleted. You will receive an HTTP 405 status when you send an unsupported HTTP method.
The XML or JSON you are sending does not conform to the schema that is used by the web service. You will receive an HTTP 400 status when you send invalid HTTP Body content.
The parameters you are sending are invalid or you are missing a required parameter. You will receive an HTTP 400 status with further information on which parameters are invalid or missing.
GET /bib/data/319501305?holdingLibraryCode=MAIN&classificationScheme=LibraryOfCongress&instSymbol=OCPSB&principalID=12345&principalIDNS=urn%3Aoclc%3Awms%3Ada HTTP/1.1 Host: worldcat.org User-Agent: Platform PHP Test Client Accept: application/atom+xml;content="application/vnd.oclc.marc21+xml" Authorization: http://www.worldcat.org/wskey/v2/hmac/v1 clientId="LOAjXFWEtkA5JHrbpu2YElhMypGHXEP9Rjp2pTt4E2GwZ1Bx0RhA7YyQutyuSXX5AAjJv1aYH0FWirC6", timestamp="1370357606", nonce="3bdf237a", signature="dnWqDMjh3o6eriU1T4aNxOF4tzEQ6H58v5lG36ErC3c=", principalID="12345", principalIDNS="urn:oclc:wms:da"
HTTP/1.1 403 Forbidden Content-type: application/xml;charset=UTF-8 Content-length: 227 Date: Tue, 04 Jun 2013 15:01:24 GMT <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <error xmlns="http://worldcat.org/xmlschemas/response"> <code>403</code> <message>User forbidden</message> <detail>PrincipalID and/or PrincipalIDNS is invalid</detail> </error>
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