OCLC Developer Network

xOCLCNum News Archive

Syndicate content

Introduction to Web Services Webinar scheduled for Thursday, July 28

Heard people talk about "using APIs and Web Services" and not quite sure what they were talking about? Or more likely--been talking about Web Services to your colleagues or manager/director and gotten blank looks?

Join Karen Coombs of the OCLC Developer Network as she demystifies the topic. Send your fellow staff members, to help them understand what you do.

Planned downtime for OCLC services on February 27 to upgrade network storage

On Sunday, February 27 there will be a scheduled service downtime for a number of OCLC services from 1:00 am until at least 6:00 am and, at most, 11:00 am (U.S. Eastern Time). We apologize for any inconvenience this causes. We need to take the following services off-line in order to upgrade the storage systems and capacity for all OCLC services. During this time, the following services will be unavailable:

Daily noncommercial usage limits raised for xISBN and xISSN

Based on feedback from OCLC Developer Network members, OCLC is pleased to announce that basic limits on all xIdentifier Web services have been increased to 1,000 queries per day. This increase is intended to facilitate easier use of the JSON-P format now in place, and is effective immediately. OCLC member libraries who also maintain an OCLC cataloguing subscription still remain eligible for higher usage limits at no charge. All other libraries and/or commercial organizations can select the subscription option that best meets their needs.

xID new features

We added a few new features to xID service: - xISSN now supports ISSN-L and RSSURL field, such as http://xissn.worldcat.org/webservices/xid/issn/1095-9203?method=getMetadata&fl=issnl,rssurl ISSN-L data is obtained from ISSN agency, and rssurl is obtained from ticTOCS. xISSN also adds values to both data set, for example, xISSN automatically adds RSSURL to all ISSNs in same group. - xOCLCNUM now supports OCLC workid, such as: http://xisbn.worldcat.org/webservices/xid/oclcnum/55847258?fl=owi And you can query by workid as well: http://xisbn.worldcat.org/webservices/xid/owi/owi718389 I highly recommend using "owi[0-9]" in its whole format when you came upon workid, this will be very helpful for identifying workid from any web pages and facilitates interoperability and mashup. For more information, please check xISSN and xOCLCNUM API.

support hathitrust.org in xoclcnum service

xOCLCNUM has a less-used, but I think very useful feature of limiting search scope to a collection, we call it search in library feature. The goal is to limit FRBR expansion to a smaller scope, such as a library or special collection. Thanks for wonderful help from Jeremy York, we recently added hathitrust.org as a collection. This feature is implemented in following way: a request can put an additional parameter "library=hathi" in xOCLCNUM request, the service will only return records which marked as free access in hathitrust.org, when I gather hathitrust data last time, we collected 189,723 free access records with OCLCNUM. Similarly, we have 129,239 free access records from Open Content Alliance, and overall there are 322,629 records about ebooks (mostly free content) in xOCLCNUM service. Besides that, because of the FRBR expansion of xOCLCNUM, when a user requests an OCLCNUM, the service can lookup other OCLCNUM with free access content in same work group, for example, OCLCNUM: 51848364 is a book in copyright, by using the search in a library request, we can tell there are multiple versions of free ebooks about this book, including copies in archive.org and hathitrust.org. I just did a quick calculation, by using the FRBR expansion, 2,446,005 OCLCNUMs can link to a version of ebook. it is still a small percentage of the worldcat database, but I suspect it might be large enough for real world usage, so it would be nice to see this feature get better usage. We have a similar feature in xISBN service, but because most free access books don't have ISBNs, the xOCLCNUM's version might be better for real world usage.

LCCN support and other improvements in xID service

We added a few more features in this month's xID deployment, hopefully it could be useful in upcoming WorldCat Hackathon . For more information, please check xISBN API, xISSN API, and xOCLCNUM API. Thanks Andrew Nagy and Jonathan Rochkind for valuable suggestions.

Introducing OCLCNUM normalization service

Thanks for great suggestion by Tod Matola in OCLC, we are introducing an OCLCNUM normalization service as part of xOCLCNUM. -- xOCLCNUM service now accepts different variants of an OCLCNUM, and always return OCLCNUM in same flavor, such as: http://xisbn.worldcat.org/webservices/xid/oclcnum/ocm55847258?method=getEditions&format=xml&fl=lccn,isbn --add a new method to generate different variants of an OCLCNUM. http://xisbn.worldcat.org/webservices/xid/oclcnum/55847258?method=getVariants&format=xml For more information, please check http://xisbn.worldcat.org/xisbnadmin/xoclcnum/api.htm#getvariants

xOCLCNUM service and its dissemination format

We recently released the xOCLCNUM service in http://xisbn.worldcat.org/xisbnadmin/xoclcnum/index.htm In the early design of xISBN service, we didn't think through all requirement for future services, so it's bit awkward that we actually use a different XML schema/namespace for xOCLCNUM service, such as: <rsp xmlns="http://worldcat.org/xid/oclcnum/" stat="ok"> <oclcnum isbn="9780596002817" lccn="2004273129">55847258</oclcnum> </rsp> However, if you prefer to use any other dissemination format, such as text or json distribution, we actually kept a consistent schema: http://xisbn.worldcat.org/webservices/xid/isbn/0596002815 ?method=getMetadata&format=python&fl=isbn,oclcnum http://xisbn.worldcat.org/webservices/xid/oclcnum/177669176 ?method=getMetadata&format=python&fl=isbn,oclcnum So any code written for xISBN should be applicable to xOCLCNUM as well if you are not using XML dissemination, otherwise you may need a little (I hope) adjustments.

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