Have runnable API examples (that can run from the documentation directly).

[almet]

It would be useful to have API usage examples that could actually trigger a request on a real service.

[almet]

Found this very nice toolkit to generate different HTTP calls examples, based on the HAR format for request/response: https://github.com/Mashape/apiembed/

[almet]

Also have a look at https://apiblueprint.org/

[almet]

Which can be used to generate docs like this: https://github.com/danielgtaylor/aglio