Update api documentation

Signed-off-by: Vitor Mattos <[email protected]>

Author: vitormattos

site/.vuepress/public/specs/api.yaml

@@ -2147,6 +2147,24 @@ paths:
                         allOf:
                           - $ref: '#/components/schemas/configureCheck'
   /admin/certificate:
+    get:
+      tags:
+        - admin
+      summary: Get root certificate
+      description: Get root certificate settings
+      operationId: admin#loadCertificate
+      security:
+        - basicAuth: []
+      responses:
+        '200':
+          description: The certificate settings
+          content:
+            application/json:
+              schema:
+                oneOf:
+                  - $ref: '#/components/schemas/certificate-cfssl'
+                  - $ref: '#/components/schemas/certificate-openssl'
+  /admin/certificate/cfssl:
     post:
       tags:
         - admin
@@ -2160,7 +2178,7 @@ paths:
           application/json:
             schema:
               allOf:
-                - $ref: '#/components/schemas/certificate'
+                - $ref: '#/components/schemas/certificate-cfssl'
       responses:
         '200':
           description: 'If the response is successful, it is because the settings have been saved and the root certificate has been generated.'
@@ -2176,7 +2194,7 @@ paths:
                     description: CFSSL server is up?
                   data:
                     allOf:
-                      - $ref: '#/components/schemas/certificate'
+                      - $ref: '#/components/schemas/certificate-cfssl'
                 required:
                   - success
                   - data
@@ -2204,22 +2222,64 @@ paths:
                   success: false
                   message:
                     - parameter 'cfsslUri' is required!
-    get:
+  /admin/certificate/openssl:
+    post:
       tags:
         - admin
-      summary: Get root certificate
-      description: Get root certificate settings
-      operationId: admin#loadCertificate
+      summary: Create root certificate
+      description: Create root certificate and enable execution of OpenSSL
+      operationId: admin#generateCertificate
       security:
         - basicAuth: []
+      requestBody:
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: '#/components/schemas/certificate-openssl'
       responses:
         '200':
-          description: The certificate settings
+          description: 'If the response is successful, it is because the settings have been saved and the root certificate has been generated.'
           content:
             application/json:
               schema:
-                allOf:
-                  - $ref: '#/components/schemas/certificate'
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    enum:
+                      - true
+                    description: CFSSL server is up?
+                  data:
+                    allOf:
+                      - $ref: '#/components/schemas/certificate-openssl'
+                required:
+                  - success
+                  - data
+                example:
+                  success: true
+        '401':
+          description: Request failed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    enum:
+                      - false
+                    description: CFSSL server is up?
+                  message:
+                    type: array
+                    description: List of failures that occurred
+                required:
+                  - success
+                  - message
+                example:
+                  success: false
+                  message:
+                    - parameter 'cfsslUri' is required!
 components:
   securitySchemes:
     basicAuth:
@@ -2807,7 +2867,7 @@ components:
           type: string
           description: Returned when the status is error. Is a tip to solve the problem.
           example: install java
-    certificate:
+    certificate-cfssl:
       type: object
       properties:
         rootCert:
@@ -2847,3 +2907,38 @@ components:
         - rootCert
         - cfsslUri
         - configPath
+    certificate-openssl:
+      type: object
+      properties:
+        rootCert:
+          type: object
+          description: Data to generate root certificate
+          properties:
+            commonName:
+              type: string
+              description: Common name
+              example: CommonName
+            names:
+              type: array
+              description: Custom cert name options
+              items:
+                type: object
+                properties:
+                  id:
+                    type: string
+                    description: Short identifier
+                    example: C
+                  value:
+                    type: string
+                    description: Value of ID
+                    example: BR
+        configPath:
+          type: string
+          description: The path that Nextcloud should save the OpenSSL root certificate.
+          example: /openssl/
+        generated:
+          type: boolean
+          description: Is OpenSSL certificate generated?
+      required:
+        - rootCert
+        - configPath