mod_rest: Add some GET-mapped iq-queries to OpenAPI documentation
authorKim Alvefur <zash@zash.se>
Sat, 31 Dec 2022 16:57:40 +0100
changeset 5127 09dd378748b8
parent 5126 25f39ceccbca
child 5128 8d5b9245275d
mod_rest: Add some GET-mapped iq-queries to OpenAPI documentation
mod_rest/README.markdown
mod_rest/res/openapi.yaml
--- a/mod_rest/README.markdown	Sat Dec 31 15:32:25 2022 +0100
+++ b/mod_rest/README.markdown	Sat Dec 31 16:57:40 2022 +0100
@@ -116,10 +116,16 @@
 
 The supported queries are
 
+-   `archive`
 -   `disco`
+-   `extdisco`
 -   `items`
+-   `lastactivity`
+-   `oob`
+-   `payload`
+-   `ping`
+-   `stats`
 -   `version`
--   `ping`
 
 ## Receiving stanzas
 
--- a/mod_rest/res/openapi.yaml	Sat Dec 31 15:32:25 2022 +0100
+++ b/mod_rest/res/openapi.yaml	Sat Dec 31 16:57:40 2022 +0100
@@ -203,6 +203,48 @@
         '200':
           $ref: '#/components/responses/success'
 
+  /rest/lastactivity/{to}:
+    get:
+      tags:
+      - query
+      summary: Query last activity of an entity. Sometimes used as "uptime" for servers.
+      security:
+      - basic: []
+      - token: []
+      parameters:
+      - $ref: '#/components/parameters/to'
+      responses:
+        '200':
+          $ref: '#/components/responses/success'
+
+  /rest/stats/{to}:
+    get:
+      tags:
+      - query
+      summary: Query an entity for statistics
+      security:
+      - basic: []
+      - token: []
+      parameters:
+      - $ref: '#/components/parameters/to'
+      responses:
+        '200':
+          $ref: '#/components/responses/success'
+
+  /rest/upload_request/{to}:
+    get:
+      tags:
+      - query
+      summary: Lorem ipsum
+      security:
+      - basic: []
+      - token: []
+      parameters:
+      - $ref: '#/components/parameters/to'
+      responses:
+        '200':
+          $ref: '#/components/responses/success'
+
 components:
   schemas:
     stanza: