--- swagger: '2.0' info: title: bar CRUD API version: 4.2.0 schemes: - http basePath: /api consumes: - application/json produces: - application/json paths: /common: get: operationId: commonGet summary: here to test path collisons responses: '200': description: OK schema: $ref: "#/definitions/bar" /bars: post: operationId: create summary: Create a new bar parameters: - name: info in: body schema: $ref: "#/definitions/bar" responses: '201': description: created schema: $ref: "#/definitions/barId" default: description: error schema: $ref: "#/definitions/error" /bars/{barid}: get: operationId: get summary: Get a bar by id parameters: - $ref: "#/parameters/barid" responses: '200': description: OK schema: $ref: "#/definitions/bar" '401': $ref: "#/responses/401" '404': $ref: "#/responses/404" default: description: error schema: $ref: "#/definitions/error" delete: operationId: delete summary: delete a bar by id parameters: - name: barid in: path required: true type: string responses: '200': description: OK '401': description: unauthorized schema: $ref: "#/definitions/error" '404': description: resource not found schema: $ref: "#/definitions/error" default: description: error schema: $ref: "#/definitions/error" post: operationId: update summary: update a bar by id parameters: - name: barid in: path required: true type: string - name: info in: body schema: $ref: "#/definitions/bar" responses: '200': description: OK '401': description: unauthorized schema: $ref: "#/definitions/error" '404': description: resource not found schema: $ref: "#/definitions/error" default: description: error schema: $ref: "#/definitions/error" definitions: common: type: object required: - id properties: id: type: string format: string minLength: 1 bar: type: object required: - name - description properties: id: type: string format: string readOnly: true name: type: string format: string minLength: 1 description: type: string format: string minLength: 1 barId: type: object required: - id properties: id: type: string format: string minLength: 1 error: type: object required: - message properties: code: type: string format: string message: type: string fields: type: string parameters: common: name: common in: query type: string barid: name: barid in: path required: true type: string responses: 401: description: bar unauthorized schema: $ref: "#/definitions/error" 404: description: bar resource not found schema: $ref: "#/definitions/error"