Documented API calls' return format.

This is in response to issue #108.

:ghost: :jack_o_lantern: :ghost: 
Might want to talk about what happens if it's not running vnc (for example, because it's off/hasn't actually been created yet).