Update API Documentation in README.rst.

[dopry]

We refactored all the optional request parameters into a params dictionary, but didn't update the README.rst at the same time. We probably also consider completing the documentation of the API parameters in the README.rst.

supercedes #30.

[dopry]

closed by #34