#%RAML 1.0
title: Demo CoffeeShop
version: v1
baseUri: https://webservice.toscacloud.com/api
mediaType: application/json

types:
  Coffee:
    type: object
    properties:
      id:
        type: integer
        required: false
      name:
        type: string
      description:
        type: string
        required: false
    example:
      id: 1
      name: Affogato
      description: An affogato (Italian, drowned) is a coffee-based beverage. It usually takes the form of a scoop of vanilla gelato or ice cream topped with a shot of hot espresso.

/Coffees:
  displayName: Coffees
  get:
    description: Returns all coffees.
    responses:
      200:
        body:
          application/json:
            type: Coffee[]
            example:
              - id: 1
                name: Affogato
                description: An affogato (Italian, drowned) is a coffee-based beverage. It usually takes the form of a scoop of vanilla gelato or ice cream topped with a shot of hot espresso. Some variations also include a shot of Amaretto or other liqueur.
              - id: 2
                name: Americano
                description: An Americano is an espresso-based drink designed to resemble coffee brewed in a drip filter, considered popular in the United States of America.
              - id: 3
                name: Bicerin
                description: Bicerin is a traditional warm coffee concoction native to Turin, Italy, made of espresso, drinking chocolate and whole milk served layered in a small rounded glass.
              - id: 4
                name: Breve
                description: Caffe Breve is an American variation of a latte; a milk-based espresso drink using steamed half-and-half mixture of milk and cream instead of milk.
              - id: 5
                name: Cafe Bombon
                description: Cafe Bombon was made popular in Valencia, Spain, and spread gradually to the rest of the country.
  post:
    description: Adds a new coffee.
    body:
      application/json:
        type: Coffee
        example:
          name: Cappuccino
          description: Espresso with steamed milk and a thick layer of foam.
    responses:
      200:
        body:
          application/json:
            type: Coffee
  put:
    description: Updates name and description of the coffee identified by id in the body.
    body:
      application/json:
        type: Coffee
        example:
          id: 1
          name: Affogato
          description: Updated affogato description.
    responses:
      200:
        body:
          application/json:
            type: Coffee
  /{id}:
    uriParameters:
      id:
        type: integer
        description: Coffee id
        example: 1
    get:
      description: Returns the coffee with the given id.
      responses:
        200:
          body:
            application/json:
              type: Coffee
              example:
                id: 1
                name: Affogato
                description: An affogato (Italian, drowned) is a coffee-based beverage. It usually takes the form of a scoop of vanilla gelato or ice cream topped with a shot of hot espresso.
    delete:
      description: Deletes the coffee with the given id.
      responses:
        200: