openapi-core/tests/integration/data/v3.0/petstore.yaml

172 lines
3.8 KiB
YAML
Raw Normal View History

2017-09-21 11:51:37 +00:00
openapi: "3.0.0"
info:
version: 1.0.0
title: Swagger Petstore
license:
name: MIT
servers:
2017-09-25 11:22:55 +00:00
- url: http://petstore.swagger.io/{version}
variables:
version:
enum:
- v1
- v2
default: v1
2017-09-21 11:51:37 +00:00
paths:
/pets:
get:
summary: List all pets
operationId: listPets
tags:
- pets
parameters:
- name: page
in: query
schema:
type: integer
format: int32
default: 1
2017-09-21 11:51:37 +00:00
- name: limit
in: query
description: How many items to return at one time (max 100)
required: true
schema:
type: integer
format: int32
2017-10-17 13:02:21 +00:00
nullable: true
2017-09-21 11:51:37 +00:00
- name: ids
in: query
description: Filter pets with Ids
schema:
type: array
items:
type: integer
format: int32
responses:
'200':
description: An paged array of pets
headers:
x-next:
description: A link to the next page of responses
schema:
type: string
content:
application/json:
schema:
$ref: "#/components/schemas/Pets"
default:
description: unexpected error
content:
application/json:
schema:
$ref: "#/components/schemas/Error"
post:
summary: Create a pet
operationId: createPets
tags:
- pets
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PetCreate'
responses:
'201':
description: Null response
default:
description: unexpected error
content:
application/json:
schema:
$ref: "#/components/schemas/Error"
/pets/{petId}:
get:
summary: Info for a specific pet
operationId: showPetById
tags:
- pets
parameters:
- name: petId
in: path
required: true
description: The id of the pet to retrieve
schema:
type: integer
format: int64
responses:
'200':
description: Expected response to a valid request
content:
application/json:
schema:
$ref: "#/components/schemas/Pets"
default:
description: unexpected error
content:
application/json:
schema:
$ref: "#/components/schemas/Error"
components:
schemas:
Address:
type: object
x-model: Address
required:
- city
properties:
street:
type: string
city:
type: string
2017-10-17 13:46:09 +00:00
Tag:
type: string
enum:
- Cat
- Dog
- Bird
Position:
type: integer
enum:
- 1
- 2
- 3
2017-09-21 11:51:37 +00:00
Pet:
type: object
x-model: Pet
allOf:
- $ref: "#/components/schemas/PetCreate"
2017-09-21 11:51:37 +00:00
required:
- id
properties:
id:
type: integer
format: int64
PetCreate:
type: object
x-model: PetCreate
2017-09-21 11:51:37 +00:00
required:
- name
properties:
name:
type: string
tag:
2017-10-17 13:46:09 +00:00
type: "#/components/schemas/Tag"
address:
$ref: "#/components/schemas/Address"
2017-10-17 13:46:09 +00:00
position:
$ref: "#/components/schemas/Position"
2017-09-21 11:51:37 +00:00
Pets:
type: array
items:
$ref: "#/components/schemas/Pet"
Error:
type: object
required:
- code
- message
properties:
code:
type: integer
format: int32
message:
type: string