New, hopefully helpful, doc on the API