Document API usage generally

The "Usage" section of the docs documents a number of APIs specifically, but doesn't talk about
 * how to authenticate
 * what the requests and success and error responses should look like