New DOAJ API and DOAJ plugin

We’ve received notification from DOAJ that their API will be changing in September, see below. Is the DOAJ plugin for OJS 3.x going to be updated as well?

"Progress report on the changes coming to the API in Q3 2020
This is the THIRD update about changes to the API which will go live in September 2020.

  1. We will be releasing a version 2 of the whole API. All the URLs that you currently use for the API are of the form “/api/v1/{endpoint}”, these will all become “/api/v2/{endpoint}”
  2. The API routes for “/api/v1/articles” and “/api/v1/articles/{article_id}” will continue to work, but they will respond with a permanent redirect to “/api/v2/articles” and “/api/v2/articles/{article_id}”. You should not have to change your article upload integration at all during this API upgrade, though you should strongly consider moving from the v1 to v2 URL routes.
  3. The data model for Journals and Applications is changing, quite significantly. This will affect all Application CRUD interfaces, Journal retrieve and Journal/Application search APIs.
  4. Attached are two files, OutgoingAPIJournal.md.txt and IncomingAPIApplication.md.txt, which show the data models of the Application and Journal models as they will appear in the new API. Full documentation is not quite done yet, but these provide a preview of the new models."
2 Likes

Hi @mreedks,

I got an error with a 3.1.2-4 OJS instance that tries, without success, to do a redirection to the DOAJ api/v2.

What I did to solve it was to simply change, within the \plugins\importexport\doaj\DOAJExportPlugin.inc.php file

define('DOAJ_API_URL', 'https://doaj.org/api/v1/');
for:
define('DOAJ_API_URL', 'https://doaj.org/api/v2/');

Best,

Marie-Hélène

3 Likes
1 Like

You’re really - really help me, thank yoouuu a lottt :sob: :innocent:

1 Like

Hello @Marie-Helene @rcgillis @asmecher, we wanted to ask you to help with this problem. We have downloaded and uploaded the xml file (correctly depending on the platform) but then in the OJS export panel the articles do not appear registered (mark to register). This is just a double check or they need to appear as “registered”. Thanks so much!panel

A life saver! Thank you very much!!

1 Like