Update API documentation with example return values

[slifty]

Now that the API is returning actual objects (instead of what was basically unstructured text...), we can update the documentation to show those objects.

We're still basically storing / passing around everything as a string at this point, but that's good enough for the short term.