nodejs-warsaw-xxi/example2b_swagger.yml

55 lines
1.3 KiB
YAML

openapi: 3.0.3
info:
title: Swagger UserApi - OpenAPI 3.0
description: |-
This is a sample User API
termsOfService: http://swagger.io/terms/
contact:
email: apiteam@swagger.io
license:
name: Apache 2.0
url: http://www.apache.org/licenses/LICENSE-2.0.html
version: 1.0.11
externalDocs:
description: Find out more about Swagger
url: http://swagger.io
tags:
- name: user
description: Information about user
paths:
/api/users:
post:
requestBody:
content:
application/json:
schema:
type: object
properties:
id:
type: number
name:
type: string
email:
format: email
type: string
age:
minimum: 0
type: number
required:
- id
- name
- email
- age
responses:
'200':
description: User created successfully
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
'400':
description: Invalid input