document HTTP interface

[bertsky]

So far we only describe the SSH / CLI calls, but our HTTP server offers a fully transparent wrapper, so the readme and mkdocs should reflect that.