At Menmo we do our best to craft a world-class API developers will love. To do that, we follow these design principles:
We put version at the top of the URI.
Currently only JSON is supported as the return format.
We may add XML or others in the future, using ".xml" and ".json" extensions.
Almost every call supports the 'callback' parameter to enable so called JSON-P.
We use 'offset' and 'limit' parameters to return a slice of a longer list.
Where search is supported, we use the "q" parameter.
Returns all players who's name contain "Zlatan".
Where sorting is supported, we use the "sort" parameter with the name of the key to sort on.
We use a few HTTP response codes to indicate when something went wrong:
- 200 - OK
- 400 - Bad Request, client did something wrong
- 404 - Not Found, no content
- 405 - Method not allowed
- 500 - Internal Server Error, server did something wrong