Merge branch 'master' into grpc_mtls

api/openapi/bootstrap.yml

@@ -1,9 +1,28 @@
 openapi: 3.0.1
 info:
   title: Mainflux Bootstrap service
-  description: HTTP API for managing platform things configuration.
-  version: "1.0.0"
+  description: |
+    HTTP API for managing platform things configuration.
+    Some useful links:
+    - [The Mainflux repository](https://github.com/mainflux/mainflux)
+  contact:
+    email: info@mainflux.com
+  license:
+    name: Apache 2.0
+    url: https://github.com/mainflux/mainflux/blob/master/LICENSE
+  version: 0.14.0
 
+servers:
+  - url: http://localhost:9013
+  - url: https://localhost:9013
+
+tags:
+  - name: configs
+    description: Everything about your Configs
+    externalDocs:
+      description: Find out more about Configs
+      url: http://docs.mainflux.io/
+
 paths:
   /things/configs:
     post:
@@ -123,6 +142,7 @@ paths:
       responses:
         '200':
           description: Config updated.
+          $ref: "#/components/responses/ConfigUpdateCertsRes"
         '400':
           description: Failed due to malformed JSON.
         '401':
@@ -239,15 +259,15 @@ components:
     Config:
       type: object
       properties:
-        mainflux_id:
+        thing_id:
           type: string
           format: uuid
           description: Corresponding Mainflux Thing ID.
         mainflux_key:
           type: string
           format: uuid
           description: Corresponding Mainflux Thing key.
-        mainflux_channels:
+        channels:
           type: array
           minItems: 0
           items:
@@ -274,6 +294,12 @@ components:
           description: Free-form custom configuration.
         state:
           $ref: "#/components/schemas/State"
+        client_cert:
+          type: string
+          description: Client certificate.
+        ca_cert:
+          type: string
+          description: Issuing CA certificate.
       required:
         - external_id
         - external_key
@@ -305,15 +331,15 @@ components:
     BootstrapConfig:
       type: object
       properties:
-        mainflux_id:
+        thing_id:
           type: string
           format: uuid
           description: Corresponding Mainflux Thing ID.
-        mainflux_key:
+        thing_key:
           type: string
           format: uuid
           description: Corresponding Mainflux Thing key.
-        mainflux_channels:
+        channels:
           type: array
           minItems: 0
           items:
@@ -331,9 +357,30 @@ components:
           type: string
           description: Issuing CA certificate.
       required:
-        - mainflux_id
-        - mainflux_key
-        - mainflux_channels
+        - thing_id
+        - thing_key
+        - channels
+        - content
+    ConfigUpdateCerts:
+      type: object
+      properties:
+        thing_id:
+          type: string
+          format: uuid
+          description: Corresponding Mainflux Thing ID.
+        client_cert:
+          type: string
+          description: Client certificate.
+        client_key:
+          type: string
+          description: Key for the client_cert.
+        ca_cert:
+          type: string
+          description: Issuing CA certificate.
+      required:
+        - thing_id
+        - thing_key
+        - channels
         - content
 
   parameters:
@@ -511,6 +558,12 @@ components:
         application/json:
           schema:
             $ref: "./schemas/HealthInfo.yml"
+    ConfigUpdateCertsRes:
+      description: Data retrieved. Config certs updated.
+      content:
+        application/json:
+          schema:
+            $ref: "#/components/schemas/ConfigUpdateCerts"
 
   securitySchemes:
     bearerAuth:

api/openapi/certs.yml

@@ -1,8 +1,27 @@
 openapi: 3.0.1
 info:
   title: Mainflux Certs service
-  description: HTTP API for Certs service
-  version: "1.0.0"
+  description: |
+    HTTP API for Certs service
+    Some useful links:
+    - [The Mainflux repository](https://github.com/mainflux/mainflux)
+  contact:
+    email: info@mainflux.com
+  license:
+    name: Apache 2.0
+    url: https://github.com/mainflux/mainflux/blob/master/LICENSE
+  version: 0.14.0
+
+servers:
+  - url: http://localhost:9019
+  - url: https://localhost:9019
+
+tags:
+  - name: certs
+    description: Everything about your Certs
+    externalDocs:
+      description: Find out more about certs
+      url: http://docs.mainflux.io/
 
 paths:
   /certs:

api/openapi/consumers-notifiers.yml

@@ -1,8 +1,30 @@
 openapi: 3.0.1
 info:
   title: Mainflux Notifiers service
-  description: HTTP API for Notifiers service.
-  version: "1.0.0"
+  description: |
+    HTTP API for Notifiers service.
+    Some useful links:
+    - [The Mainflux repository](https://github.com/mainflux/mainflux)
+  contact:
+    email: info@mainflux.com
+  license:
+    name: Apache 2.0
+    url: https://github.com/mainflux/mainflux/blob/master/LICENSE
+  version: 0.14.0
+
+servers:
+  - url: http://localhost:9014
+  - url: https://localhost:9014
+  - url: http://localhost:9015
+  - url: https://localhost:9015
+
+tags:
+  - name: notifiers
+    description: Everything about your Notifiers
+    externalDocs:
+      description: Find out more about notifiers
+      url: http://docs.mainflux.io/
+
 paths:
   /subscriptions:
     post:

api/openapi/http.yml

@@ -1,8 +1,28 @@
 openapi: 3.0.1
 info:
   title: Mainflux http adapter
-  description: HTTP API for sending messages through communication channels.
-  version: "1.0.0"
+  description: |
+    HTTP API for sending messages through communication channels.
+    Some useful links:
+    - [The Mainflux repository](https://github.com/mainflux/mainflux)
+  contact:
+    email: info@mainflux.com
+  license:
+    name: Apache 2.0
+    url: https://github.com/mainflux/mainflux/blob/master/LICENSE
+  version: 0.14.0
+
+servers:
+  - url: http://localhost:8008
+  - url: https://localhost:8008
+
+tags:
+  - name: messages
+    description: Everything about your Messages
+    externalDocs:
+      description: Find out more about messages
+      url: http://docs.mainflux.io/
+
 paths:
   /channels/{id}/messages:
     post:

api/openapi/provision.yml

@@ -1,8 +1,27 @@
 openapi: 3.0.1
 info:
   title: Mainflux Provision service
-  description: HTTP API for Provision service
-  version: "1.0.0"
+  description: |
+    HTTP API for Provision service
+    Some useful links:
+    - [The Mainflux repository](https://github.com/mainflux/mainflux)
+  contact:
+    email: info@mainflux.com
+  license:
+    name: Apache 2.0
+    url: https://github.com/mainflux/mainflux/blob/master/LICENSE
+  version: 0.14.0
+
+servers:
+  - url: http://localhost:9016
+  - url: https://localhost:9016
+
+tags:
+  - name: provision
+    description: Everything about your Provision
+    externalDocs:
+      description: Find out more about provision
+      url: http://docs.mainflux.io/
 
 paths:
   /mapping:

api/openapi/readers.yml

@@ -1,8 +1,35 @@
 openapi: 3.0.1
 info:
   title: Mainflux reader service
-  description: HTTP API for reading messages.
-  version: "1.0.0"
+  description: |
+    HTTP API for reading messages.
+    Some useful links:
+    - [The Mainflux repository](https://github.com/mainflux/mainflux)
+  contact:
+    email: info@mainflux.com
+  license:
+    name: Apache 2.0
+    url: https://github.com/mainflux/mainflux/blob/master/LICENSE
+  version: 0.14.0
+
+servers:
+  - url: http://localhost:9003
+  - url: https://localhost:9003
+  - url: http://localhost:9005
+  - url: https://localhost:9005
+  - url: http://localhost:9007
+  - url: https://localhost:9007
+  - url: http://localhost:9009
+  - url: https://localhost:9009
+  - url: http://localhost:9011
+  - url: https://localhost:9011
+
+tags:
+  - name: readers
+    description: Everything about your Readers
+    externalDocs:
+      description: Find out more about readers
+      url: http://docs.mainflux.io/
 
 paths:
   /channels/{chanId}/messages:
@@ -14,7 +41,7 @@ paths:
         ensure that the entire dataset is consumed either by making subsequent
         requests, or by increasing the subset size of the initial request.
       tags:
-        - messages
+        - readers
       parameters:
         - $ref: "#/components/parameters/ChanId"
         - $ref: "#/components/parameters/Limit"