swagger: '2.0' info: title: Hello API version: "0.1" paths: /greeting: get: operationId: api.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 /hero/{id}: get: 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 put: 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 402: description: Duplicate name 403: description: Some error 404: description: Hero not found /hero: post: 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 /heroes: get: 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 definitions: Hero: description: Hero type type: object properties: id: type: integer name: type: string