Recently, I have been spending time looking at the Swagger 2.0 Specification. There XML representation and Enumerations are tricky. Here is an example of a Swagger Enumeration in YAML.
You can test the YAML at http://petstore.swagger.io/#!/default/get_demo
| #YAML Demonstration | |
| swagger: '2.0' | |
| info: | |
| title: Demonstration of Swagger Yaml with Enumeration | |
| description: Simple Demonstration of Enumeration | |
| version: "1.0.0" | |
| host: api.bastide.org | |
| schemes: | |
| - https | |
| basePath: /1 | |
| produces: | |
| - application/atom+xml | |
| paths: | |
| /demo: | |
| get: | |
| summary: demonstration for enumeration | |
| description: | | |
| Demonstrates an enumeration | |
| parameters: | |
| - name: day | |
| in: query | |
| description: day of the week | |
| required: true | |
| type: string | |
| enum: | |
| - Monday | |
| - Tuesday | |
| - Wednesday | |
| - Thursday | |
| - Friday | |
| - Saturday | |
| - Sunday | |
| responses: | |
| 200: | |
| description: The response upon succesful query | |
| default: | |
| description: Error occured |
by