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

207 lines
4.5 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-10-19 11:28:28 +00:00
- name: search
in: query
description: Search query
schema:
type: string
default: ""
allowEmptyValue: 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
2017-11-14 16:05:03 +00:00
- name: tags
in: query
description: Filter pets with tags
schema:
type: array
items:
$ref: "#/components/schemas/Tag"
explode: false
2017-09-21 11:51:37 +00:00
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:
2017-11-06 16:50:00 +00:00
$ref: "#/components/schemas/PetsData"
2017-09-21 11:51:37 +00:00
post:
summary: Create a pet
operationId: createPets
tags:
- pets
requestBody:
2017-11-02 16:05:25 +00:00
required: true
2017-09-21 11:51:37 +00:00
content:
application/json:
schema:
$ref: '#/components/schemas/PetCreate'
responses:
'201':
description: Null response
default:
2018-04-04 10:26:21 +00:00
$ref: "#/components/responses/ErrorResponse"
2017-09-21 11:51:37 +00:00
/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:
2017-11-06 16:50:00 +00:00
$ref: "#/components/schemas/PetData"
2017-09-21 11:51:37 +00:00
default:
2017-11-06 14:57:08 +00:00
$ref: "#/components/responses/ErrorResponse"
2017-09-21 11:51:37 +00:00
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:
2017-11-14 13:36:05 +00:00
- cats
- dogs
- birds
2017-10-17 13:46:09 +00:00
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-11-14 13:36:05 +00:00
$ref: "#/components/schemas/Tag"
address:
$ref: "#/components/schemas/Address"
2017-10-17 13:46:09 +00:00
position:
$ref: "#/components/schemas/Position"
2018-02-28 12:01:05 +00:00
healthy:
type: boolean
2017-09-21 11:51:37 +00:00
Pets:
2017-11-06 16:50:00 +00:00
type: array
items:
$ref: "#/components/schemas/Pet"
PetsData:
2017-11-06 13:32:31 +00:00
type: object
2017-11-06 16:50:00 +00:00
required:
- data
properties:
data:
$ref: "#/components/schemas/Pets"
PetData:
type: object
required:
- data
2017-11-06 13:32:31 +00:00
properties:
data:
2017-11-06 16:50:00 +00:00
$ref: "#/components/schemas/Pet"
2017-09-21 11:51:37 +00:00
Error:
type: object
required:
- code
- message
properties:
code:
type: integer
format: int32
message:
2017-11-06 14:57:08 +00:00
type: string
2018-04-04 10:26:21 +00:00
ExtendedError:
allOf:
- $ref: "#/components/schemas/Error"
- type: object
required:
- rootCause
properties:
rootCause:
type: string
2017-11-06 14:57:08 +00:00
responses:
ErrorResponse:
description: unexpected error
content:
application/json:
schema:
2018-04-04 10:26:21 +00:00
$ref: "#/components/schemas/ExtendedError"