#%RAML 1.0 title: Fake Better API version: 1.0.0 baseUri: http://api.betterapis.com/ baseUriParamaters: {} documentation: - title: Fake Better API content: This is a basic example API for our talk at http://betterapis.com. types: Foo: displayName: Foo description: An example type of object type: object properties: name: required: false displayName: name type: string score: required: false displayName: score type: integer format: int32 /foo: get: displayName: listFoo queryParameters: limit: required: false default: 10 displayName: limit description: maximum number of foo to return type: integer format: int32 responses: 200: description: List all foo body: application/json: displayName: response description: List all foo type: array items: type: Foo put: displayName: putFoo body: text/plain: displayName: foo description: Data representing a foo type: Foo responses: 200: description: Updates a foo body: text/plain: displayName: response description: Updates a foo type: any 400: description: Invalid foo data body: {} post: displayName: postFoo body: text/plain: displayName: foo description: Data representing a foo type: Foo responses: 200: description: Creates a foo body: text/plain: displayName: response description: Creates a foo type: any 400: description: Invalid foo data body: {} /{fooId}: uriParameters: fooId: required: true displayName: fooId description: ID of the foo type: string get: displayName: getFooByID responses: 200: description: Foo with the specified ID body: text/plain: displayName: response description: Foo with the specified ID type: any 404: description: Foo with specified ID not found body: {}