mokapi-example/openapi.yml at main · marle3003/mokapi-example · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
openapi: 3.0.0
servers:
  - url: /
info:
  description: |
     This is a sample Motorcycle Store based on the [OpenAPI 3.0 specification](https://swagger.io/docs/specification/about/).
paths:
  /makes:
    get:
      summary: Gets all makes
      responses:
        '200':
          description: A list of makes
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: 'models.yml#/Make'
                example:
                  - id: 1
                    name: BMW
                  - id: 2
                    name: Honda
                  - id: 3
                    name: Kawasaki
components:
  schemas:
    $ref: 'models.yml'