FORMAT: 1A
HOST: http://api.betterapis.com/

# Fake Better API
This is a basic example API for our talk at http://betterapis.com.

# Foo [/foo{?limit}]

## listFoo [GET]
+ Parameters
    + limit (number, optional) -

        maximum number of foo to return

        + Default: 10

+ Response 200 (application/json)

        List all foo

    + Attributes (array[Foo])


# Foo [/foo]

## putFoo [PUT]

+ Request (application/json)
    + Attributes (Foo)


+ Response 200 

        Updates a foo

    + Attributes (object)


+ Response 400 

        Invalid foo data


## postFoo [POST]

+ Request (application/json)
    + Attributes (Foo)


+ Response 200 

        Creates a foo

    + Attributes (object)


+ Response 400 

        Invalid foo data


# Foo By FooId [/foo/{fooId}]

+ Parameters
    + fooId (string, required)

        ID of the foo


## getFooByID [GET]

+ Response 200 

        Foo with the specified ID

    + Attributes (object)


+ Response 404 

        Foo with specified ID not found


# Data Structures

## Foo (object)
An example type of object

### Properties
+ `name` (string, optional) 
+ `score` (number, optional)