Announcing the new Member API

Announcing the new Member API

When we launched the new version of the OAI-PMH service in November (Hallett (2019)), and retired Solr (used by the old OAI-PMH service) in December, we completed the transition to Elasticsearch as our search index, and the REST API as our main API. All our services now integrate via Elasticsearch and the REST API, including:

  1. MDS API - DOI registration API
  2. EZ API - DOI registration API, compatible with CDL EZID service
  3. Fabrica - DOI registration and account management web interface
  4. OAI-PMH - Metadata harvesting
  5. DataCite Search - public DOI search
  6. Stats Portal - statistics about DOI registrations and resolutions
  7. Content Negotiation - DOI metadata in other formats

This consolidation was a lot of work in 2019, but will greatly simplify the maintenance of our services and the development of new functionality going forward.!

This consolidation of course also has its downsides, and the most important one is supporting both member services and public services via the same API. While DataCite will always make all DOI metadata available in a public API and search interface, we also have to make sure our paying members get the best possible service quality when registering DOIs or otherwise interacting with DataCite services as member.

To address this challenge we have in December split the REST API into two versions: a Public API and a Member API. These two APIs use exactly the same URLs (starting with https://api.datacite.org), run exactly the same code, and provide exactly the same public data, the only difference being that traffic is directed to a different set of servers if users authenticate as a member. This change is subtle enough that you probably have not noticed the change yet.

The launch of separate Public and Member APIs allows us to monitor the uptime and response time for DataCite member services separately from our public services, and adjust as needed. We updated the DataCite status page to reflect this change, you can now see separate metrics (both response time and request count) for the Public API and Member API:

There are of course other approaches to separate out member API calls from public API calls, including separate API endpoints, e.g. pub.orcid.org vs. api.orcid.org at ORCID, or separate APIs for members and non-members, e.g. the separate DOI registration API at Crossref. But we feel that our approach for accessing the member vs. public API aligns best with our strategy of offering a consolidated REST API for all services.

This blog post was originally published on the DataCite Blog.

References

Hallett R. OAI-PMH Service Updates. Published online November 25, 2019. doi:10.5438/PPTH-PZ62

Copyright © 2020 Martin Fenner. Distributed under the terms of the Creative Commons Attribution 4.0 License.