fix: properly document /users/login

openapi/generate_openapi.py

@@ -932,20 +932,26 @@ paths:
       operationId: login
       summary: Login with REST API
       consumes:
-        - application/x-www-form-urlencoded
         - application/json
+        - application/x-www-form-urlencoded
       tags:
         - Login
       parameters:
-        - name: username
+        - name: loginRequest
-          in: formData
+          in: body
           required: true
+          description: Login credentials
+          schema:
+            type: object
+            required:
+              - username
+              - password
+            properties:
+              username:
                 description: |
                   Your username
                 type: string
-        - name: password
+              password:
-          in: formData
-          required: true
                 description: |
                   Your password
                 type: string
@@ -955,22 +961,32 @@ paths:
           description: |-
             Successful authentication
           schema:
-            items:
+            type: object
+            required:
+              - id
+              - token
+              - tokenExpires
             properties:
               id:
                 type: string
+                description: User ID
               token:
                 type: string
+                description: |
+                  Authentication token
               tokenExpires:
                 type: string
+                format: date-time
+                description: |
+                  Token expiration date
         400:
           description: |
             Error in authentication
           schema:
-            items:
+            type: object
             properties:
               error:
-                  type: number
+                type: string
               reason:
                 type: string
         default:

public/api/wekan.yml

@@ -31,45 +31,61 @@ paths:
       operationId: login
       summary: Login with REST API
       consumes:
-        - application/x-www-form-urlencoded
         - application/json
+        - application/x-www-form-urlencoded
       tags:
         - Login
       parameters:
-        - name: username
+        - name: loginRequest
-          in: formData
+          in: body
           required: true
+          description: Login credentials
+          schema:
+            type: object
+            required:
+              - username
+              - password
+            properties:
+              username:
+                type: string
                 description: |
                   Your username
-          type: string
+              password:
-        - name: password
-          in: formData
-          required: true
-          description: |
-            Your password
                 type: string
                 format: password
+                description: |
+                  Your password
       responses:
         200:
           description: |-
             Successful authentication
           schema:
-            items:
+            type: object
+            required:
+              - id
+              - token
+              - tokenExpires
             properties:
               id:
                 type: string
+                description: User ID
               token:
                 type: string
+                description: |
+                  Authentication token
               tokenExpires:
                 type: string
+                format: date-time
+                description: |
+                  Token expiration date
         400:
           description: |
             Error in authentication
           schema:
-            items:
+            type: object
             properties:
               error:
-                  type: number
+                type: string
               reason:
                 type: string
         default: