swagger-in-docker-template/example2.yaml at master · doubledare704/swagger-in-docker-template · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
openapi: 3.0.0
info:
  title: Sample API
  description: Optional multiline or single-line description in [CommonMark](http://commonmark.org/help/) or HTML.
  version: 0.1.9
servers:
  - url: http://api.example.com/v1
    description: Optional server description, e.g. Main (production) server
  - url: http://staging-api.example.com
    description: Optional server description, e.g. Internal staging server for testing
paths:
  /connections:
    get:
      summary: Returns list of connections between users
      responses:
        '200':    # status code
          description: A JSON array of user connections
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string