A bunch of companies use Swagger/IO Docs for their API docs, which allows you to enter parameters and actually try it out right there on the page - you can see

A bunch of companies use Swagger/IO Docs for their API docs, which allows you to enter parameters and actually try it out right there on the page - you can see the actual http request and response. When it comes to API docs, my ideal preference is for curl command-line examples, since that is sort of a universal "least common denominator" that works anywhere, everyone can understand. It also takes your particular client out of the equation.