fix: properly document /users/login

This commit is contained in:
Yang, Bo 2025-06-12 01:30:43 +00:00
parent 7bf75b1ff7
commit e14a3f9c2d
2 changed files with 86 additions and 54 deletions

View file

@ -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
in: formData
- name: loginRequest
in: body
required: true
description: Login credentials
schema:
type: object
required:
- username
- password
properties:
username:
description: |
Your username
type: string
- name: password
in: formData
required: true
password:
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:

View file

@ -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
in: formData
- name: loginRequest
in: body
required: true
description: Login credentials
schema:
type: object
required:
- username
- password
properties:
username:
type: string
description: |
Your username
type: string
- name: password
in: formData
required: true
description: |
Your password
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: