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: get: operationId: heroes.get_hero summary: Returns hero by id parameters: - name: id in: query type: integer required: true responses: 200: description: Successful response. schema: $ref: '#/definitions/Hero' 404: description: Hero not found /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