78 lines
1.9 KiB
YAML
78 lines
1.9 KiB
YAML
/users:
|
|
get:
|
|
operationId: getAllUsers
|
|
tags:
|
|
- users
|
|
summary: Get all users
|
|
description: Retrieve a list of all users
|
|
parameters:
|
|
- name: limit
|
|
in: query
|
|
schema:
|
|
type: integer
|
|
default: 30
|
|
- name: skip
|
|
in: query
|
|
schema:
|
|
type: integer
|
|
default: 0
|
|
responses:
|
|
'200':
|
|
description: Successful response
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
users:
|
|
type: array
|
|
items:
|
|
$ref: '#/components/schemas/User'
|
|
total:
|
|
type: integer
|
|
skip:
|
|
type: integer
|
|
limit:
|
|
type: integer
|
|
post:
|
|
operationId: createUser
|
|
tags:
|
|
- users
|
|
summary: Add a new user
|
|
security:
|
|
- bearerAuth: []
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/User'
|
|
responses:
|
|
'201':
|
|
description: User created successfully
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/User'
|
|
/users/{id}:
|
|
get:
|
|
operationId: getUserById
|
|
tags:
|
|
- users
|
|
summary: Get a single user
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: integer
|
|
responses:
|
|
'200':
|
|
description: Successful response
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/User'
|
|
'404':
|
|
description: User not found
|