Improve API documentation.

Add more detailed description of POST and multi-GET return objects.
Add missing "image" field for the URL for a peoplewatch.