• Everyday by browsing sites.
  • During early development prior to interface integration.
  • Manual testing of a newly deployed though not necessarily automated feature.
  • Production, or other higher order environment, diagnosing reported issues.
  • Penetration testing to provide unexpected data to a service.

Tools

A workflow

Swagger

Using Swagger?

An approach is to import the definition into Postman where a Collection will be made. From this collection Requests can be exported to cURL/HttpClient/Unirest/Httpie specific commands.

Not using Swagger?

As a form of documentation of an existing, non Swagger, API we could leverage the OpenAPIs Specification to describe the models, paths and security. We now can import this into Postman.

However, as a result of the disconnect between the API implementation and our documentation we now assume the responsibility of maintaining integrity between the two - should the API change we need to update our documentation.

Use Case

There are times as we progress through the release pipeline and we find ourselves working on the command line directly on an application instance (possibly due to VPC, firewall or routing configuration).Using Postman as a local library of CLI commands to be pasted onto the server will assist with this task.

Further Reading