{"id":3363,"date":"2021-09-21T12:36:35","date_gmt":"2021-09-21T11:36:35","guid":{"rendered":"https:\/\/blog.doaj.org\/?p=3363"},"modified":"2021-09-21T12:36:35","modified_gmt":"2021-09-21T11:36:35","slug":"forthcoming-change-to-our-api","status":"publish","type":"post","link":"https:\/\/blog.doaj.org\/de\/2021\/09\/21\/forthcoming-change-to-our-api\/","title":{"rendered":"Forthcoming change to our API"},"content":{"rendered":"\n

We are making a change to our API on 30th September which will break integrations for publishers sending applications or updates to us.<\/em><\/p>\n\n\n\n

On 30th September 2021<\/strong>, 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”).\u00a0This change will affect publishers that are sending applications to us via the API.\u00a0<\/strong><\/p>\n\n\n\n

From 30th September, all applications sent to us must have that piece of metadata present in the JSON.<\/p>\n\n\n\n

The new line in the incoming application model<\/a> will look like this: <\/p>\n\n\n\n

“oa_start”: 1900,<\/p>\n\n\n\n

and in context: <\/p>\n\n\n\n

],
“oa_start”: 1900,
“other_charges”: {
“has_other_charges”: true,
“url”: “string”
},
“pid_scheme”: {
“has_pid_scheme”: true,
“scheme”: [
“string”
]<\/p>\n\n\n\n

(The incoming application model<\/a> documentation will be updated on 30th September.)<\/p>\n\n\n\n

We will also bump the API version from 2.0.0 to 3.0.0 in line with Semantic Versioning<\/a>. Even though the API version is being bumped, all existing integrations for depositing article metadata will continue to work.<\/p>\n\n\n\n

We will set up the following URL routes and redirects:
\/api\/v1 \u2192 \/api\/v3
\/api\/v2 \u2192 \/api\/v3
\/api \u2192 \/api\/v3
\/api\/v3 where v3 will be the current version<\/p>\n\n\n\n

Please look out for further notifications in the API announcement group<\/a>, where this information has also been posted.<\/p>\n\n\n\n

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.<\/p>\n","protected":false},"excerpt":{"rendered":"

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”).\u00a0This change will affect publishers…<\/p>","protected":false},"author":378,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_s2mail":"","_kadence_starter_templates_imported_post":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"categories":[616],"tags":[72,73],"class_list":["post-3363","post","type-post","status-publish","format-standard","hentry","category-metadata","tag-api","tag-apichange"],"_links":{"self":[{"href":"https:\/\/blog.doaj.org\/de\/wp-json\/wp\/v2\/posts\/3363","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.doaj.org\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.doaj.org\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.doaj.org\/de\/wp-json\/wp\/v2\/users\/378"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.doaj.org\/de\/wp-json\/wp\/v2\/comments?post=3363"}],"version-history":[{"count":0,"href":"https:\/\/blog.doaj.org\/de\/wp-json\/wp\/v2\/posts\/3363\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.doaj.org\/de\/wp-json\/wp\/v2\/media?parent=3363"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.doaj.org\/de\/wp-json\/wp\/v2\/categories?post=3363"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.doaj.org\/de\/wp-json\/wp\/v2\/tags?post=3363"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}