openapi: '3.0.0'
info:
  title: Simple API overview
  version: v2
servers:
  - url: http://backend.com/path
x-kong-service-defaults:
  retries: 10
  connect_timeout: 30000
  write_timeout: 30000
  read_timeout: 30000
x-kong-upstream-defaults:
  hash_on: ip
  healthchecks:
    passive:
      unhealthy:
        http_failures: 3
        tcp_failures: 3
        timeouts: 3
paths:
  /:
    x-kong-name: x-kong-name-override-at-path-item
    get:
      x-kong-name: x-kong-name-override-at-method
      operationId: listVersionsv2
      summary: List API versions
      responses:
        '200':
          description: |-
            200 response
          content:
            application/json:
              examples:
                foo:
                  value:
                    {
                      'versions':
                        [
                          {
                            'status': 'CURRENT',
                            'updated': '2011-01-21T11:33:21Z',
                            'id': 'v2.0',
                            'links':
                              [
                                {
                                  'href': 'http://127.0.0.1:8774/v2/',
                                  'rel': 'self',
                                },
                              ],
                          },
                          {
                            'status': 'EXPERIMENTAL',
                            'updated': '2013-07-23T11:33:21Z',
                            'id': 'v3.0',
                            'links':
                              [
                                {
                                  'href': 'http://127.0.0.1:8774/v3/',
                                  'rel': 'self',
                                },
                              ],
                          },
                        ],
                    }
        '300':
          description: |-
            300 response
          content:
            application/json:
              examples:
                foo:
                  value: |
                    {
                     "versions": [
                           {
                             "status": "CURRENT",
                             "updated": "2011-01-21T11:33:21Z",
                             "id": "v2.0",
                             "links": [
                                 {
                                     "href": "http://127.0.0.1:8774/v2/",
                                     "rel": "self"
                                 }
                             ]
                         },
                         {
                             "status": "EXPERIMENTAL",
                             "updated": "2013-07-23T11:33:21Z",
                             "id": "v3.0",
                             "links": [
                                 {
                                     "href": "http://127.0.0.1:8774/v3/",
                                     "rel": "self"
                                 }
                             ]
                         }
                     ]
                    }
  /v2:
    x-kong-name: x-kong-name-override-at-path-item
    get:
      operationId: getVersionDetailsv2
      summary: Show API version details
      responses:
        '200':
          description: |-
            200 response
          content:
            application/json:
              examples:
                foo:
                  value:
                    {
                      'version':
                        {
                          'status': 'CURRENT',
                          'updated': '2011-01-21T11:33:21Z',
                          'media-types':
                            [
                              {
                                'base': 'application/xml',
                                'type': 'application/vnd.openstack.compute+xml;version=2',
                              },
                              {
                                'base': 'application/json',
                                'type': 'application/vnd.openstack.compute+json;version=2',
                              },
                            ],
                          'id': 'v2.0',
                          'links':
                            [
                              {
                                'href': 'http://127.0.0.1:8774/v2/',
                                'rel': 'self',
                              },
                              {
                                'href': 'http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf',
                                'type': 'application/pdf',
                                'rel': 'describedby',
                              },
                              {
                                'href': 'http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl',
                                'type': 'application/vnd.sun.wadl+xml',
                                'rel': 'describedby',
                              },
                              {
                                'href': 'http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl',
                                'type': 'application/vnd.sun.wadl+xml',
                                'rel': 'describedby',
                              },
                            ],
                        },
                    }
        '203':
          description: |-
            203 response
          content:
            application/json:
              examples:
                foo:
                  value:
                    {
                      'version':
                        {
                          'status': 'CURRENT',
                          'updated': '2011-01-21T11:33:21Z',
                          'media-types':
                            [
                              {
                                'base': 'application/xml',
                                'type': 'application/vnd.openstack.compute+xml;version=2',
                              },
                              {
                                'base': 'application/json',
                                'type': 'application/vnd.openstack.compute+json;version=2',
                              },
                            ],
                          'id': 'v2.0',
                          'links':
                            [
                              {
                                'href': 'http://23.253.228.211:8774/v2/',
                                'rel': 'self',
                              },
                              {
                                'href': 'http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf',
                                'type': 'application/pdf',
                                'rel': 'describedby',
                              },
                              {
                                'href': 'http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl',
                                'type': 'application/vnd.sun.wadl+xml',
                                'rel': 'describedby',
                              },
                            ],
                        },
                    }
