hypermedia API post

@driki @kookster @farski @eveadele 
Maybe also point to the concerns, and mention we have implemented caching, though this is probably not the right post to get into the details of how it works beyond saying it uses russian doll style.