SHERPA   
. . . opening access to research  
spacer

API Implications of the Recent SHERPA/RoMEO Upgrade

A new version of SHERPA/RoMEO was released on the 15th August 2011. The main change was the introduction of a new database that improves the coverage and accuracy of journal information. Full details of the new and improved features can be found in the news item: "SHERPA RoMEO Upgrade Version Released".

This news item outlines the effects the upgrade has on the RoMEO API.

New API Version 2.9

Firstly, we have released a new version of the API - version 2.9 - that uses the new RoMEO Journals database. The base URL is:

http://www.sherpa.ac.uk/romeo/api29.php

This version also has additional features and optional query arguments, of which the main ones are:

Further information and documentation for Version 2.9 is available at:

http://www.sherpa.ac.uk/romeo/apimanual.php

REST-style URLs

Please note also that we now have REST-style URLs for specific human RoMEO pages, e.g.:

Migrating Applications

The new API works exactly as before, so you may only need to change the base URL in your applications. However, we suggest that you may also wish to upgrade your applications to exploit the new API features.

Please note that V.2.9 has a usage cap of 500 requests per day per IP address. This should be sufficient for most repository applications, but could affect large application such as CRIS systems. With efficient practices, the cap should not be a problem even for these systems. For more advice on efficient use of the API, please see the poster we presented at OAI7:

http://www.sherpa.ac.uk/documents/Millington-OAI7-poster.pdf

Older API Versions

Version 2.4 of the API (and later prototype versions) have been converted to use the new Journals database, and will continue to be supported for the foreseeable future. The main differences you may notice are fewer failed journal queries, and fewer journals returning multiple publishers. However, you need to upgrade to V.2.9 if you wish to exploit the new features.

Earlier 2.x versions (V.2.1 to 2.3) still use the original RoMEO database tables, which will not longer be updated. You therefore must upgrade your applications if you are using these versions. In September 2011, we will start redirecting requests for these versions to V.2.9. This probably will not adversely affect applications, but there is a risk it might. We plan to delete these early versions completely by the end of November 2011.

Future Registration of API Users

We plan to introduce a registration system in the near future for regular and heavy API users. This will permit registered users to exceed the daily usage cap, which is mainly necessary for initial processing of large bibliographies or for research purposes. It will also ensure that registered users receive advanced notice of future developments, and timely notification of service issues.

Please contact us at romeo@jisc.ac.uk if you have any queries or concerns about the upgrade or future planned changes, or are interested in registering.

This work is licensed under CC BY-NC-ND. About using our content Contact us