From the documentation (e.g., for OJS 3.3) we can get the following picture. The endpoint /submissions/{submissionId} returns JSON with the publications array. Each item of this array should be identical to what is returned from the /submissions/{submissionId}/publications/{publicationId} endpoint (I even used diff to compare). This is logical from the point of view that the description of the publications should be identical regardless of the way it is received.
The actual behavior is as follows: only from /submissions/{submissionId}/publications/{publicationId} can I get a complete description of the publication. The keys for these publication objects are:
0: “_href”
1: “abstract”
2: “accessStatus”
3: “authors”
4: “authorsString”
5: “authorsStringShort”
6: “categoryIds”
7: “citations”
8: “citationsRaw”
9: “copyrightHolder”
10: “copyrightYear”
11: “coverImage”
12: “coverage”
13: “datePublished”
14: “disciplines”
15: “doiSuffix”
16: “fullTitle”
17: “galleys”
18: “hideAuthor”
19: “id”
20: “issueId”
21: “keywords”
22: “languages”
23: “lastModified”
24: “licenseUrl”
25: “locale”
26: “pages”
27: “prefix”
28: “primaryContactId”
29: “pub-id::doi”
30: “pub-id::publisher-id”
31: “rights”
32: “sectionId”
33: “seq”
34: “source”
35: “status”
36: “subjects”
37: “submissionId”
38: “subtitle”
39: “supportingAgencies”
40: “title”
41: “type”
42: “urlPath”
43: “urlPublished”
44: “version”
The JSON items (objects? I never knew how to name them properly) from the publications array fetched from /submissions/{submissionId} are missing some fields. Here, the keys are:
0: “_href”
1: “authorsString”
2: “authorsStringShort”
3: “categoryIds”
4: “coverImage”
5: “datePublished”
6: “doiSuffix”
7: “fullTitle”
8: “galleys”
9: “id”
10: “locale”
11: “pages”
12: “prefix”
13: “primaryContactId”
14: “pub-id::doi”
15: “pub-id::publisher-id”
16: “sectionId”
17: “status”
18: “submissionId”
19: “subtitle”
20: “title”
21: “urlPublished”
22: “version”
Depending on the developers’ intentions, either the documentation or the code should be changed to bring them into agreement.
The issue is relevant for OJS 3.3.0.22 and 3.5.0.1 (haven’t tested in other versions).
PS sorry for the title, couldn’t invent a more concise description