hypermedia API post

@driki @kookster @farski @eveadele 
The concerns are under that link, I think that going much further might warrant a post if you're willing to write one.