diff options
author | edyta <edyta.krukowska@nokia.com> | 2020-04-16 09:39:48 +0200 |
---|---|---|
committer | edyta <edyta.krukowska@nokia.com> | 2020-04-16 10:29:51 +0200 |
commit | 5f9406058b6a22e3e52989cd14b88e44005b2ed9 (patch) | |
tree | bc90c5da8ec34c2429c4cedeae25d9529f67eaa3 | |
parent | 1740a80eab8ebb9598b7e9a19632a17491811be2 (diff) |
Formated offered apis yaml
Issue-ID: AAF-1091
Signed-off-by: Edyta Krukowska <edyta.krukowska@nokia.com>
Change-Id: I5a103ef53b62c6dec849ff51cc871df26a7922c2
-rw-r--r-- | docs/OpenAPI.yaml (renamed from certService/OpenAPI.yaml) | 0 | ||||
-rw-r--r-- | docs/README.md | 2 | ||||
-rw-r--r-- | docs/sections/offeredapis.rst | 162 |
3 files changed, 2 insertions, 162 deletions
diff --git a/certService/OpenAPI.yaml b/docs/OpenAPI.yaml index 14f8b6bc..14f8b6bc 100644 --- a/certService/OpenAPI.yaml +++ b/docs/OpenAPI.yaml diff --git a/docs/README.md b/docs/README.md index 15deadea..3cd6e5e4 100644 --- a/docs/README.md +++ b/docs/README.md @@ -8,7 +8,7 @@ To generate a documentation locally follow below steps. 2. Install all required dependencies ``` - python install -r requirements-docs.txt + pip install -r requirements-docs.txt ``` 3. Generate local documentation ``` diff --git a/docs/sections/offeredapis.rst b/docs/sections/offeredapis.rst index 61c5bc33..5874ccf9 100644 --- a/docs/sections/offeredapis.rst +++ b/docs/sections/offeredapis.rst @@ -9,164 +9,4 @@ Offered APIs AAF Cert Service Api -------------------- -.. code-block:: yaml - - openapi: 3.0.1 - info: - title: CertService Documentation - description: Certification service API documentation - version: 1.0.0 - servers: - - url: http://localhost:8080 - description: Generated server url - tags: - - name: Actuator - description: Monitor and interact - externalDocs: - description: Spring Boot Actuator Web API Documentation - url: https://docs.spring.io/spring-boot/docs/current/actuator-api/html/ - paths: - /v1/certificate/{caName}: - get: - tags: - - CertificationService - summary: sign certificate - description: Web endpoint for requesting certificate signing. Used by system - components to gain certificate signed by CA. - operationId: signCertificate - parameters: - - name: caName - in: path - description: Name of certification authority that will sign CSR. - required: true - schema: - type: string - - name: CSR - in: header - description: Certificate signing request in form of PEM object encoded in - Base64 (with header and footer). - required: true - schema: - type: string - - name: PK - in: header - description: Private key in form of PEM object encoded in Base64 (with header - and footer). - required: true - schema: - type: string - responses: - "200": - description: certificate successfully signed - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/CertificationModel' - "500": - description: something went wrong during connecting to cmp client - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/ErrorResponseModel' - "404": - description: CA not found for given name - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/ErrorResponseModel' - "400": - description: given CSR or/and PK is incorrect - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/ErrorResponseModel' - /ready: - get: - tags: - - CertificationService - summary: check is container is ready - description: Web endpoint for checking if service is ready to be used. - operationId: checkReady - responses: - "200": - description: configuration is loaded and service is ready to use - content: - application/json; charset=utf-8: - schema: - type: string - "503": - description: configuration loading failed and service is unavailable - content: - application/json; charset=utf-8: - schema: - type: string - /reload: - get: - tags: - - CertificationService - summary: reload service configuration from file - description: Web endpoint for performing configuration reload. Used to reload - configuration file from file. - operationId: reloadConfiguration - responses: - "200": - description: configuration has been successfully reloaded - content: - application/json; charset=utf-8: - schema: - type: string - "500": - description: something went wrong during configuration loading - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/ErrorResponseModel' - /actuator/health: - get: - tags: - - Actuator - summary: Actuator web endpoint 'health' - operationId: handle_0 - responses: - "200": - description: default response - content: {} - /actuator/health/**: - get: - tags: - - Actuator - summary: Actuator web endpoint 'health-path' - operationId: handle_1 - responses: - "200": - description: default response - content: {} - /actuator: - get: - tags: - - Actuator - summary: Actuator root web endpoint - operationId: links_2 - responses: - "200": - description: default response - content: {} - components: - schemas: - ErrorResponseModel: - type: object - properties: - errorMessage: - type: string - CertificationModel: - type: object - properties: - certificateChain: - type: array - items: - type: string - trustedCertificates: - type: array - items: - type: string - +.. openapi:: ../OpenAPI.yaml |