1swagger: "2.0"
2info:
3  version: 1.0.0
4  title: Swagger Petstore
5  license:
6    name: MIT
7host: petstore.swagger.io
8basePath: /v1
9schemes:
10  - http
11consumes:
12  - application/json
13produces:
14  - application/json
15paths:
16  /pets:
17    get:
18      summary: List all pets
19      operationId: listPets
20      tags:
21        - pets
22      parameters:
23        - name: limit
24          in: query
25          description: How many items to return at one time (max 100)
26          required: false
27          type: integer
28          format: int32
29      responses:
30        "200":
31          description: An paged array of pets
32          headers:
33            x-next:
34              type: string
35              description: A link to the next page of responses
36          schema:
37            $ref: 'definitions.yaml#/Pets'
38        default:
39          description: unexpected error
40          schema:
41            $ref: 'error.json'
42    post:
43      summary: Create a pet
44      operationId: createPets
45      tags:
46        - pets
47      responses:
48        "201":
49          description: Null response
50        default:
51          description: unexpected error
52          schema:
53            $ref: 'error.json'
54  /pets/{petId}:
55    get:
56      summary: Info for a specific pet
57      operationId: showPetById
58      tags:
59        - pets
60      parameters:
61        - overwritten: some value
62          $ref: 'definitions.yaml#/id'
63      responses:
64        "200":
65          description: Expected response to a valid request
66          schema:
67            $ref: 'http://finkhaeuser.de/projects/prance/petstore.yaml#/definitions/Pet'
68        default:
69          description: unexpected error
70          schema:
71            $ref: '#/definitions/Error'
72definitions:
73  Error:
74    required:
75      - code
76      - message
77    properties:
78      code:
79        type: integer
80        format: int32
81      message:
82        type: string
83