We are making a change to our API on 30th September which will break integrations for publishers sending applications or updates to us.
On 30th September 2021, we will reinstate a compulsory question in the DOAJ application form that asks for the date that the journal was fully open access. (“oa_start”). This change will affect publishers that are sending applications to us via the API.
From 30th September, all applications sent to us must have that piece of metadata present in the JSON.
The new line in the incoming application model will look like this:
and in context:
(The incoming application model documentation will be updated on 30th September.)
We will also bump the API version from 2.0.0 to 3.0.0 in line with Semantic Versioning. Even though the API version is being bumped, all existing integrations for depositing article metadata will continue to work.
We will set up the following URL routes and redirects:
/api/v1 → /api/v3
/api/v2 → /api/v3
/api → /api/v3
/api/v3 where v3 will be the current version
Please look out for further notifications in the API announcement group, where this information has also been posted.
If you belong to an organisation that routinely sends new applications or updates to DOAJ via our API and you would like a dedicated email to your inbox, please contact me with your email address, DOAJ account number(s) and the name of the publisher you represent.