---
swagger: "2.0"

info:
  title: |
    Title
  version: 0.0.1
  description: |
    # First heading

    Some description, with `monospace`, _italic_, and **bold**.

    <aside class="success">
    Custom HTML
    </aside>

    ## Second level heading

    > Multi
    > line
    > quote

    And also some code with syntax highlighting
    ```json
    { "foo" :
      [ "bar", "baz" ]
    }
    ```
  contact:
    name: Contact name
    url: https://example.com/
    email: contact@example.com
  termsOfService: |
    Here goes the terms of service.
  license:
    name: Whatever you want

host: example.com

basePath: /base/path

schemes:
  - https

tags:
  - name: Tag1
  - name: Tag2

paths:
  /foo/bar:
    get:
      summary: Summary text
      tags:
        - Tag1
        - Tag2
      description: |
        Description text
      responses:
        200:
          description: |
            Response description `HTTP 200`

parameters:
  Parameter1:
    name: parameter_1_name
    in: path
    required: true
    description: |
      Parameter1 description
    type: integer
    format: int64

responses:
  Response1:
    description: Response description
    schema:
      $schema: "http://json-schema.org/draft-04/schema#"
      title: Response schema title
      type: object
      description: Response schema description
      properties:
        id:
          description: Foobar
          type: string
          readOnly: true
      example:
        {
          "id": "bazbaz"
        }