Update API documentation

[jhanninen]

API documentation might not be updated after recent changes. Documentation also doesn't tell anything about the data returned by endpoints. At least some information of the data model and some notes how the data is generated for endpoints should be added.