swagger: '2.0' info: title: Heroes version: "0.1" paths: /greeting/hello: get: tags: [ "greeting" ] operationId: greeting.say_hello summary: Returns a greeting parameters: - name: name in: query type: string responses: 200: description: Successful response. schema: type: object properties: message: type: string description: Message greeting /heroes/hero/{id}: get: tags: [ "heroes" ] operationId: heroes.get_hero summary: Returns hero by id parameters: - name: id in: path type: integer required: true responses: 200: description: Successful response. schema: $ref: '#/definitions/Hero' 404: description: Hero not found 500: description: Some server error put: tags: [ "heroes" ] operationId: heroes.put_hero summary: Update a hero parameters: - name: id in: path type: integer required: true - name: hero in: body required: true schema: $ref: '#/definitions/Hero' responses: 200: description: Hero updated 403: description: Some error 409: description: Duplicate name 404: description: Hero not found 500: description: Some server error /heroes/hero: post: tags: [ "heroes" ] operationId: heroes.post_hero summary: Insert a hero parameters: - name: hero in: body required: true schema: $ref: '#/definitions/Hero' responses: 200: description: Hero inserted 403: description: Some error 409: description: Duplicate name 500: description: Some server error /heroes/heroes: get: tags: [ "heroes" ] operationId: heroes.get_heroes summary: Returns all heroes responses: 200: description: Successful response. schema: type: array items: $ref: '#/definitions/Hero' 404: description: No heroes available 500: description: Some server error definitions: Hero: description: Hero type type: object properties: id: type: integer name: type: string