Skip to content

Commit

Permalink
CST-5249 contract update according to backend latest implementations
Browse files Browse the repository at this point in the history
  • Loading branch information
frabacche committed Dec 18, 2023
1 parent 3713042 commit aaa2366
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 21 deletions.
5 changes: 3 additions & 2 deletions qualityassuranceevents.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ Return a single quality assurance event:
"originalId": "oai:www.openstarts.units.it:10077/21486",
"title":"Index nominum et rerum",
"trust":"0.375",
"topic":"ENRICH/MISSING/ABSTRACT",
"eventDate": "2020/10/09 10:11 UTC",
"status": "PENDING",
"message" : {
Expand All @@ -42,13 +43,13 @@ Attributes
* the *originalId* attribute is the identifier used by the event's source for the target publication
* the *title* attribute is the title of the publication as provided by the correction's source
* the *trust* attribute is the level of accuracy of the quality assurance event (values from 0.00 to 1.00)
* the *topic* attribute is the name of the topic of the event
* the *status* attribute is one of (ACCEPTED, REJECTED, DISCARDED, PENDING)
* the *eventDate* attribute is the timestamp of the event reception
* the *message* attribute is a json object which structure depends on the source and on the topic of the event. When the "topic" type is
* ENRICH/MISSING/PID and ENRICH/MORE/PID: fills `message.type` with the type of persistent identifier (doi, pmid, etc.) and `message.value` with the corresponding value
* ENRICH/MISSING/ABSTRACT: fills `message.abstract`
* ENRICH/MISSING/SUBJECT/ACM: fills the `message.value` with the actual keywords, the subject classification is defined by the last part of the topic (ACM, JEL, DDC, etc.)
* ENRICH/MISSING/PROJECT: fills `acronym`, `code`, `funder`, `fundingProgram`, `jurisdiction` and `title`
* ENRICH/MISSING/PROJECT and ENRICH/MORE/PROJECT: fills `acronym`, `code`, `funder`, `fundingProgram`, `jurisdiction` and `title`

Exposed links:
* topic: link to the topic to which the event belong to (see [qualityassurancetopics](qualityassurancetopics.md))
Expand Down
31 changes: 12 additions & 19 deletions qualityassurancetopics.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,27 +8,22 @@ It returns the list of the Quality Assurance Broker topics.
[

{
id: "ENRICH!MORE!PID",
type: "qualityassurancetopic",
name: "ENRICH/MORE/PID",
key: "ENRICH!MORE!PID",
lastEvent: "2020/10/09 10:11 UTC",
totalSuggestions: "33"
totalEvents: "33"
},
{
id: "ENRICH!MISSING!ABSTRACT",
type: "qualityassurancetopic",
name: "ENRICH/MISSING/ABSTRACT",
key: "ENRICH!MISSING!ABSTRACT",
lastEvent: "2020/10/09 10:11 UTC",
totalSuggestions: "21"
totalEvents: "21"
},
...
]
```
Attributes:
* name: the name of the topic to display on the frontend user interface
* key: the name of the topic to display on the frontend user interface
* lastEvent: the date of the last update from Quality Assurance Broker
* totalEvents: the total number of quality assurance events provided by Quality Assurance Broker for this topic
* id: is the identifier to use in GET Single Topic

Return codes:
* 200 OK - if the operation succeed
Expand All @@ -41,15 +36,13 @@ Return codes:
Provide detailed information about a specific Quality Assurance Broker topic. The JSON response document is as follow
```json
{
id: "ENRICH!MORE!PID",
type: "qualityassurancetopic",
name: "ENRICH/MORE/PID",
lastEvent: "2020/10/09 10:11 UTC",
totalEvents: 33
}
```
{
key: "ENRICH!MORE!PID",
lastEvent: "2020/10/09 10:11 UTC",
totalEvents: "33"
}
```

Return codes:
* 200 OK - if the operation succeed
* 401 Unauthorized - if you are not authenticated
Expand Down

0 comments on commit aaa2366

Please sign in to comment.