Postman is an API platform for building and using APIs. Postman simplifies each step of the API lifecycle and streamlines collaboration so you can create better APIs—faster.
We recently switched from Swagger UI to Postman documentation and it's a real lifesaver to have API testing and docs integrated! Here are some suggestions which would make the documentation even better:
Optionally integrate example responses (which are already saved in collection request examples)
(I see now that https://docs.api.getpostman.com/ already has this, but can't seem to get it to work.)
Ability to re-order examples in the Postman app, and reflect in documentation
Ability to enable/disable languages for code samples (i.e. we want to only include cURL code examples and link to SDKs for other languages)
Include the Authorization header when Bearer Token is selected as the Auth method for a request
Ability to style the variables (i.e. {{token}}) by wrapping those in i.e. a <span class="variable"/> element in request URI, headers, params, code examples, etc.
We recently switched from Swagger UI to Postman documentation and it's a real lifesaver to have API testing and docs integrated! Here are some suggestions which would make the documentation even better:
Authorization
header when Bearer Token is selected as the Auth method for a request{{token}}
) by wrapping those in i.e. a<span class="variable"/>
element in request URI, headers, params, code examples, etc.