From aaa23668e7b9c602909e5054554dc654ed4a11ae Mon Sep 17 00:00:00 2001
From: frabacche <francesco.bacchelli@4science.com>
Date: Mon, 18 Dec 2023 10:46:37 +0100
Subject: [PATCH] CST-5249 contract update according to backend latest
 implementations

---
 qualityassuranceevents.md |  5 +++--
 qualityassurancetopics.md | 31 ++++++++++++-------------------
 2 files changed, 15 insertions(+), 21 deletions(-)

diff --git a/qualityassuranceevents.md b/qualityassuranceevents.md
index b73e67a0..b81c185d 100644
--- a/qualityassuranceevents.md
+++ b/qualityassuranceevents.md
@@ -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" : {
@@ -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))
diff --git a/qualityassurancetopics.md b/qualityassurancetopics.md
index aec80ce5..f3020d41 100644
--- a/qualityassurancetopics.md
+++ b/qualityassurancetopics.md
@@ -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
@@ -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