Improve README to describe core functionality.

[jrdoane]

Often when I'm trying to use this library, I need to read the code to figure out how the request function works as well as manually inspecting the return values of calling it. More formal documentation for how all publicly exposed functions work would greatly improve my ability to use this library, otherwise I'm just feeling my way around until I get it right.