With REST we can use Swagger, RAML or other technologies to document our API and generate an HTML documentation that our consumers can read without any need of interaction with
If you're a Sphinx / ReadTheDocs User, you may find https://github.com/hasura/sphinx-graphiql useful.