Documented API calls' return format.

This is in response to issue #108.

:ghost: :jack_o_lantern: :ghost: 
The VNC port will be 'None'  (see ``Headnode.get_vncport`` in ``model.py``)