YamlMerger/Tests/YAMLMergerTests/Schema/04_Paths/users.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