Documented API calls' return format.

This is in response to issue #108.

:ghost: :jack_o_lantern: :ghost: 
I don't really know what happens in this case.  I would assume that the connection is just rejected?