ROR data dump: New Zenodo API requests for downloading latest files

[Liz Krznarich]

Hi all,

ROR data dump users may have noticed that the Zenodo API requests listed in our documentation have stopped working within the past week. This is due to a major software upgrade implemented by Zenodo on 13 Oct 2023.

IMPORTANT! IF YOU CURRENTLY DOWNLOAD ROR DATA DUMP FILES FROM ZENODO, YOU WILL NEED TO UPDATE YOUR CODE TO USE THE NEW ZENODO API REQUESTS!

Our docs have now been updated with the new Zenodo API requests at https://ror.readme.io/docs/data-dump#download-ror-data-dumps-programmatically-with-the-zenodo-api . See below for a summary of the changes.

What's changed?

The request path and query structure for retrieving the list of records in the ror-data Zenodo community has changed. The community name "ror-data" is now part of the path portion and the sort parameter value is now "newest".

• Previous request URI: https://zenodo.org/api/records/?communities=ror-data&sort=mostrecent
• New request URI: https://zenodo.org/api/communities/ror-data/records?q=&sort=newest

The response body has changed. File download URL is now located in files.links.download rather than files.links.self .

The file download URI ends in a path portion rather than a file extension, so when using cURL, it's necessary to redirect output to a file, ex curl -o "v1.34-2023-10-12-ror-data.zip" https://zenodo.org/api/records/8436953/files/v1.34-2023-10-12-ror-data.zip/content

• Previous file download URI: https://zenodo.org/api/files/25d4f93f-6854-4dd4-9954-173197e7fad7/v1.1-2022-06-16-ror-data.zip
• New file download URI: https://zenodo.org/api/records/8436953/files/v1.34-2023-10-12-ror-data.zip/content

Please note that Zenodo is continuing to experience some instability following the updated, and Zenodo developer docs do not appear to be updated with the API changes yet.

As always, please let us know if you run into any issues by replying here or contacting us at sup...@ror.org.

Cheers,

Liz

Liz Krznarich

ROR Technical Lead

kerz-NAR-itch | she/her | US central time (GMT-5)

https://orcid.org/0000-0001-6622-4910
l...@ror.org | https://ror.org | @ResearchOrgs

[Liz Krznarich]

Hi folks,

A user alerted us to the fact that the Zenodo API has changed again. File download URL has reverted back to being files.links.self rather than files.links.download. The other changes appear to still be correct.

Additionally, hits.hits[0].files previously included file items for all versions but now appears to only contain a single item for the most recent version. Records for previous versions can be obtained using the URL in hits.hits[0].links.versions, and the file URL can be extracted from each individual record.

Docs have been updated with all of this info https://ror.readme.io/docs/data-dump#download-ror-data-dumps-programmatically-with-the-zenodo-api, but please note that this may be subject to change as the updated Zenodo API continues to evolve.

Cheers,

Liz