---
swagger: "2.0"
info:
  version: "0.1.0"
  title: reference analysis

parameters:
  idParam:
    name: id
    in: path
    type: integer
    format: int32
  limitParam:
    name: limit
    in: query
    type: integer
    format: int32
    required: false

responses:
  notFound:
    schema:
      $ref: "#/definitions/error"

paths:
  "/some/where/{id}":
    parameters:
      - $ref: "#/parameters/idParam"

      - name: bodyId
        in: body
        schema:
          type: object
    get:
      parameters:
      - $ref: "#/parameters/limitParam"
      - name: other
        in: query
        type: array
        items:
          # NOTE: $ref here is forbidden in swagger 2.0 
          # however, it is possible to analyze this
          $ref: "#/definitions/named"
      - name: otherHeader
        in: header
        type: array
        items:
          # NOTE: $ref here is forbidden in swagger 2.0 
          # however, it is possible to analyze this
          $ref: "#/definitions/named"
      - name: body
        in: body
        schema:
          type: object
      responses:
        default:
          headers:
            x-array-header:
              type: array
              items:
                # NOTE: $ref here is forbidden in swagger 2.0 
                # however, it is possible to analyze this
                $ref: '#/definitions/named'
          schema:
            type: object
        404:
          $ref: "#/responses/notFound"
        200:
          schema:
            $ref: "#/definitions/tag"
  "/other/place":
    $ref: "#/x-shared-path/getItems"

definitions:
  named:
    type: string
  tag:
    type: object
    properties:
      id:
        type: integer
        format: int64
      value:
        type: string
      audit:
        $ref: "#/definitions/record"
  record:
    type: object
    properties:
      createdAt:
        type: string
        format: date-time
  error:
    type: object
    required:
      - id
      - message
    properties:
      id:
        type: integer
        format: int64
        readOnly: true
      message:
        type: string
        readOnly: true