Revize e23248ed

Re #8708 - Changed the swagger.yaml accordingly to the previous REST API endpoint changes (/api/certificate/{id}/identity endpoint)

Changed method from POST to GET.
Changed 201 status code to 200.
Improved status code descriptions.
Improved ID parameter description.
Market IdentityRequest parameters as required.

src/swagger.yaml

@@ -367 +367 @@
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
   /api/certificates/{id}/identity:
-    post:
+    get:
       tags:
       - certificates
       summary: Create a PCKS12 identity
@@ -376 +376 @@
       parameters:
       - name: id
         in: path
-        description: ID of a certificate whose private key is to be queried
+        description: ID of a certificate whose PKCS12 identity should be created
         required: true
         style: simple
         explode: false
         schema:
           $ref: '#/components/schemas/IdParameter'
       requestBody:
-        description: Certificate data to be created
+        description: Identity data to be created
         content:
           application/json:
             schema:
               $ref: '#/components/schemas/IdentityRequest'
       responses:
-        "201":
-          description: identity created
+        "200":
+          description: identity successfully generated and returned
           content:
             application/x-pkcs12:
               schema:
                 type: string
                 format: binary
         "400":
-          description: invalid input, object invalid
+          description: missing required parameters
           content:
             application/json:
               schema:
@@ -659 +659 @@
         name:
           type: string
           example: Jane Doe
+          required: true
         password:
           type: string
           example: passphrase
+          required: true