The documentation is here: https://wikimedia.org/api/rest_v1/?doc.
http://rest.wikimedia.org/en.wikipedia.org/v1/?doc (deprecated documentation)
But we need friendlier docs.
I am assigning this to mforns cause I think the small showcase application will inform the documentation we need to provide.