SP-13696: Openapi corrections

Author: GubinAlexander

common.yml

@@ -5,15 +5,13 @@ components:
     page:
       name: page
       in: query
-      required: true
       description: "The page number to get a list of persons or groups."
       schema:
         type: integer
         default: 1
     size:
       name: size
       in: query
-      required: true
       description: "The page size with a list of persons or groups, items."
       schema:
         type: integer
@@ -412,6 +410,10 @@ components:
         msg:
           type: string
           description: "Error message."
+        metadata:
+          type: object
+          additionalProperties: true
+          description: "A free-form object containing group's extended attributes."
     Page:
       type: object
       description: "Information about current page number and total pages count"

identification.yml

@@ -59,6 +59,7 @@ components:
         name:
           type: string
           description: "Person name."
+          required: true
         metadata:
           type: object
           additionalProperties: true
@@ -69,6 +70,24 @@ components:
           items:
             type: string
             format: uuid
+    PersonToUpdateFields:
+      type: object
+      description: "Person Request body: name and metadata."
+      properties:
+        name:
+          type: string
+          description: "Person name."
+        metadata:
+          type: object
+          additionalProperties: true
+          description: "A free-form object containing person's extended attributes."
+        groups:
+          type: array
+          description: "Groups a person should be placed to. If no group is specified in request, a Default group is created and the person is placed to it."
+          items:
+            type: string
+            format: uuid
+
     ImageFields:
       type: object
       description: "Image in the request data, includes image and contentType."
@@ -101,6 +120,62 @@ components:
         limit:
           type: integer
           description: "The maximum number of results to be returned."
+
+    AddImageToPersonResponse:
+      type: object
+      description: "Image in the response."
+      properties:
+        id:
+          type: string
+          description: "Response image ID. The list is sorted by decreasing ID value."
+        contentType:
+          type: string
+          description: "Original media type of the returned image."
+        createdAt:
+          type: string
+          description: "Returned image creation date."
+        path:
+          type: string
+          description: "Returned image path."
+        url:
+          type: string
+          description: "Returned image URL."
+        metadata:
+          type: object
+          additionalProperties: true
+          description: "A free-form object containing person's extended attributes."
+
+    AddImageToPersonRequest:
+      type: object
+      description: "Image in the request data, includes image and contentType."
+      required:
+        - image
+      properties:
+        tag:
+          type: string
+          description: "Session identificator."
+        image:
+          type: object
+          description: "Uploaded image."
+          properties:
+            contentType:
+              type: string
+              description: "Original media type of the uploaded image."
+            content:
+              $ref: "./common.yml#/components/schemas/ImageData"
+            imageUrl:
+              type: string
+              description: "Image URL."
+            resizeOptions:
+              $ref: "#/components/schemas/ResizeOptions"
+        threshold:
+          type: number
+          format: float
+          description: "The similarity threshold."
+        limit:
+          type: integer
+          description: "The maximum number of results to be returned."
+
     ResizeOptions:
       type: object
       description: "Set to resize the original image."
@@ -115,6 +190,7 @@ components:
           type: integer
           default: 100
           description: "Resized image quality, percent."
+
     Image:
       type: object
       description: "Image in the response."
@@ -141,6 +217,7 @@ components:
           type: object
           additionalProperties: true
           description: "A free-form object containing person's extended attributes."
+
     GroupPage:
       allOf:
         - type: object
@@ -153,7 +230,7 @@ components:
         - $ref: './common.yml#/components/schemas/Page'
     Group:
       allOf:
-        - $ref: '#/components/schemas/GroupToCreate'
+        - $ref: '#/components/schemas/GroupResponse'
         - type: object
           description: "Additional group data in the response, includes id and createdAt."
           properties:
@@ -164,6 +241,21 @@ components:
             createdAt:
               type: string
               description: "Group creation date."
+
+    GroupResponse:
+      type: object
+      description: "Response group create data, includes name and metadata."
+      properties:
+        name:
+          type: string
+          required: true
+          description: "Group to create name."
+        metadata:
+          type: object
+          required: true
+          additionalProperties: true
+          description: "A free-form object containing group's extended attributes."
+
     GroupToCreate:
       type: object
       description: "Request body of the group to create data, includes name and metadata."
@@ -173,8 +265,10 @@ components:
           description: "Session identificator."
         name:
           type: string
+          required: true
           description: "Group to create name."
         metadata:
           type: object
+          required: true
           additionalProperties: true
           description: "A free-form object containing group's extended attributes."

matching.yml

@@ -128,6 +128,10 @@ components:
               description: "The array of matching results."
               items:
                 $ref: "#/components/schemas/MatchImageResult"
+            metadata:
+              type: object
+              additionalProperties: true
+              description: "A free-form object containing person's extended attributes."
 
     MatchImageResult:
       type: object

persons.yml

@@ -48,7 +48,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "./identification.yml#/components/schemas/PersonFields"
+              $ref: "./identification.yml#/components/schemas/PersonToUpdateFields"
       responses:
         204:
           $ref: "#/components/responses/SuccessEmpty"
@@ -102,14 +102,15 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "./identification.yml#/components/schemas/ImageFields"
+              $ref: "./identification.yml#/components/schemas/AddImageToPersonRequest"
+
       responses:
         200:
           description: "Successful operation; return image ID."
           content:
             application/json:
               schema:
-                $ref: "./identification.yml#/components/schemas/Image"
+                $ref: "./identification.yml#/components/schemas/AddImageToPersonResponse"
         400:
           $ref: "./common.yml#/components/responses/BadRequest"
         404: