Add missing totem APIs

Author: tollsimy

openapi.yaml

@@ -1767,7 +1767,7 @@ paths:
           $ref: '#/components/responses/ForbiddenError'
       security: []
 
-  /totems/register:
+  /totems:
     post:
       tags:
         - totem
@@ -1803,18 +1803,76 @@ paths:
         '404':
           $ref: '#/components/responses/NotFoundError'
       security: []
+    
+    get:
+      tags:
+        - totem
+      summary: Get all totems
+      description: Get all registered totems
+      operationId: getAllTotems
+      parameters:
+        - name: limit
+          in: query
+          description: Maximum number of items to return
+          required: false
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 100
+            default: 20
+        - name: offset
+          in: query
+          description: Number of items to skip
+          required: false
+          schema:
+            type: integer
+            minimum: 0
+            default: 0
+      responses:
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/TotemResponse'
+        '400':
+          $ref: '#/components/responses/InvalidInputError'
+        '422':
+          $ref: '#/components/responses/ValidationError'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
+        '503':
+          $ref: '#/components/responses/UnexpectedError'
+        '401':
+          $ref: '#/components/responses/UnauthorizedError'
+        '403':
+          $ref: '#/components/responses/ForbiddenError'
+        '404':
+          $ref: '#/components/responses/NotFoundError'
+      security: []
+
+  /totems/{id}:
+    parameters:
+      - name: id
+        in: path
+        description: MAC address of the totem to return
+        required: true
+        schema:
+          type: string
+          example: "AA:BB:CC:DD:EE:FF"
 
-  /totems/config:
     get:
       tags:
         - totem
       summary: Get totem configuration
-      description: Returns the configuration for a specific totem based on its MAC address
+      description: Get the configuration of a specific totem by its ID
       operationId: getTotemConfig
       parameters:
         - name: id
           in: query
-          description: MAC address of the totem
+          description: ID of the totem to retrieve
           required: true
           schema:
             type: string
@@ -1842,6 +1900,30 @@ paths:
           $ref: '#/components/responses/NotFoundError'
       security: []
 
+    delete:
+      tags:
+        - totem
+      summary: Delete a totem by ID
+      description: Delete a totem by its ID
+      operationId: deleteTotemById
+      responses:
+        '204':
+          description: Totem deleted successfully
+        '400':
+          $ref: '#/components/responses/InvalidInputError'
+        '422':
+          $ref: '#/components/responses/ValidationError'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
+        '503':
+          $ref: '#/components/responses/UnexpectedError'
+        '401':
+          $ref: '#/components/responses/UnauthorizedError'
+        '403':
+          $ref: '#/components/responses/ForbiddenError'
+        '404':
+          $ref: '#/components/responses/NotFoundError'
+
 components:
   schemas: