Onionoo protocol spec should be an api-doc

It would be nice if onionoo protocol spec could be more like an api doc with actual methods examples and return code snippets.

Ex: https://petstore.swagger.io/#/pet/findPetsByStatus