Web service keys, commonly referred to as WSKeys, are the primary method used for authenticating and authorizing interactions with web services available on the OCLC WorldShare Platform. WSKeys authenticate clients sending requests to web services, in effect, creating a “secure pipe” between a remote client and the data and functionality available on the Platform. This means a couple of things that you should be aware of as you register:
To request a WSKey for use either in the Platform test environment or in a production context, you'll need to access the OCLC Service Configuration, for which you'll need an OCLC WorldCat.org user account. If you don't currently have an OCLC account, it's easy to request one.
You can learn more about WSKeys here.
The first thing you’ll need to do is select which environment you want a WSKey for. Do you want to test in the Sandbox environment, or are you requesting access to your data in the Production environment? We always recommend that you do your initial development, testing and QA work in the Sandbox environment first.
Next, we need to know if you are a WMS site creating an OpenSocial App uploaded to an OCLC container, or whether you’ll be creating an Application hosted on your server.
If you are developing an application using an OAuth flow, you’ll need to provide the Redirect URL for your application.
Select the Web Service(s) you want this WSKey associated with.
After sending the request, you’ll need to fill in the Personal Information section. Be sure to include your institution’s OCLC symbol to expedite the process.
There are two exceptional types of usage that we ask about. Leave both boxes blank if neither matches your intended use of the WSKey.
Only commercial partners need to check this box.
If you anticipate reading and/or updating data for an institution other than your own, please check this box. Common cases in which this scenario applies include consortia who are accessing data for multiple institutions or or commercial partners accessing a library's data in WMS. If your only intended use of other institutions’ data is through the WorldCat Search API, you do not need to check this box. If you are unsure, please describe your intended use of the service in the comments and we will make sure your key is configured properly.
You must explicitly verify that you have read the Terms & Conditions that are in place between OCLC and the institution for which you are acting.
Once you have completed the form, you may be able to view your WSKey right away. Some requests will require processing time. In any case, the WSKey details will be emailed to the address you provided.
See our Authentication page for more information about how to use your WSKey.
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