53 lines
1.0 KiB
YAML
53 lines
1.0 KiB
YAML
openapi: 3.1.0
|
|
info:
|
|
title: Demo API
|
|
version: 1.0.0
|
|
servers:
|
|
- url: https://example.com
|
|
paths:
|
|
/api/users:
|
|
get:
|
|
operationId: listUsers
|
|
tags:
|
|
- users
|
|
parameters:
|
|
- name: limit
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: integer
|
|
responses:
|
|
"200":
|
|
description: Users listed.
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
post:
|
|
operationId: createUser
|
|
tags:
|
|
- users
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
responses:
|
|
"201":
|
|
description: User created.
|
|
/api/private/{userId}:
|
|
get:
|
|
operationId: getPrivateUser
|
|
tags:
|
|
- private
|
|
parameters:
|
|
- name: userId
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
"200":
|
|
description: Private user details.
|