Utilities / Application Utilities / API Tools

Decision at Segment about Swagger UI,, Markdown, Postman, QA, Api, Documentation

Avatar of nzoschke
Engineering Manager at Segment ·

We just launched the Segment Config API (try it out for yourself here) — a set of public REST APIs that enable you to manage your Segment configuration. A public API is only as good as its #documentation. For the API reference doc we are using Postman.

Postman is an “API development environment”. You download the desktop app, and build API requests by URL and payload. Over time you can build up a set of requests and organize them into a “Postman Collection”. You can generalize a collection with “collection variables”. This allows you to parameterize things like username, password and workspace_name so a user can fill their own values in before making an API call. This makes it possible to use Postman for one-off API tasks instead of writing code.

Then you can add Markdown content to the entire collection, a folder of related methods, and/or every API method to explain how the APIs work. You can publish a collection and easily share it with a URL.

This turns Postman from a personal #API utility to full-blown public interactive API documentation. The result is a great looking web page with all the API calls, docs and sample requests and responses in one place. Check out the results here.

Postman’s powers don’t end here. You can automate Postman with “test scripts” and have it periodically run a collection scripts as “monitors”. We now have #QA around all the APIs in public docs to make sure they are always correct

Along the way we tried other techniques for documenting APIs like or Swagger UI. These required a lot of effort to customize.

Writing and maintaining a Postman collection takes some work, but the resulting documentation site, interactivity and API testing tools are well worth it.

29 upvotes·1 comment·79.4K views

Decision at Gentlent about TensorFlow, Let's Encrypt, Twilio, PayPal, Stripe, CloudFlare, Google Maps, Google Drive, Stack Overflow, Postman, Google Analytics

Avatar of tomklein
CEO at Gentlent ·

Google Analytics is a great tool to analyze your traffic. To debug our software and ask questions, we love to use Postman and Stack Overflow. Google Drive helps our team to share documents. We're able to build our great products through the APIs by Google Maps, CloudFlare, Stripe, PayPal, Twilio, Let's Encrypt, and TensorFlow.

9 upvotes·22.4K views

Decision at NHS Digital (NHS.UK) about Visual Studio, Visual Studio Code, Newman, Postman, Azure DevOps, Git, jQuery, JavaScript, Microsoft SQL Server, C#, .NET Core

Avatar of nrogoff
Avanade UK Ltd. ·

Secure Membership Web API backed by SQL Server. This is the backing API to store additional profile and complex membership metadata outside of an Azure AD B2C provider. The front-end using the Azure AD B2C to allow 3rd party trusted identity providers to authenticate. This API provides a way to add and manage more complex permission structures than can easily be maintained in Azure AD.

We have .Net developers and an Azure infrastructure environment using server-less functions, logic apps and SaaS where ever possible. For this service I opted to keep it as a classic WebAPI project and deployed to AppService.

  • Trusted Authentication Provider: @AzureActiveDirectoryB2C
  • Frameworks: .NET Core
  • Language: C# , Microsoft SQL Server , JavaScript
  • IDEs: Visual Studio Code , Visual Studio
  • Libraries: jQuery @EntityFramework, @AutoMapper, @FeatureToggle , @Swashbuckle
  • Database: @SqlAzure
  • Source Control: Git
  • Build and Release Pipelines: Azure DevOps
  • Test tools: Postman , Newman
  • Test framework: @nUnit, @moq
  • Infrastructure: @AzureAppService, @AzureAPIManagement
7 upvotes·17.1K views

Decision at The Coders Zone about Postman, Stripe Billing, CloudFlare

Avatar of pauladams
Founder; CEO; Lead Full Stack Developer at The Coders Zone ·

We have used CloudFlare ourselves for many years and have been delighted with the enhanced performance of static content on our website and security benefits (such as DDOS mitigation and the web application firewall) for our APIs and client dashboard. Stripe Billing is a straightforward solution to recurring billing and the developer-friendly API allows us to automate the billing process from start to finish. Postman a great tool for testing APIs. Life without it would be a whole lot more difficult.

7 upvotes·13.3K views

Decision at ucreate about Postman

Avatar of jagdeepsingh-ucreate
Tech Lead at ·

I use Postman because of the ease of team-management, using workspaces and teams, runner, collections, environment variables, test-scripts (post execution), variable management (pre and post execution), folders (inside collections, for better management of APIs), newman, easy-ci-integration (and probably a few more things that I am not able to recall right now).

6 upvotes·1 comment·10.6K views

Decision at TOMIS about Postman

Avatar of blairg23
Chief Technology Officer at TOMIS ·

We use Postman because it's easy to start creating HTTP calls to our RESTful API, is self-documenting, can create beautiful documentation with very little effort, and can quickly and easily run regression tests to see where your problem endpoints are! It can be as simple or complex as the use case requires!

2 upvotes·5.4K views

Decision about Postman

Avatar of shridhardalavi

Postman is a powerful tool for performing integration testing with your API. It allows for repeatable, reliable tests that can be automated and used in a variety of environments and includes useful tools for persisting data and simulating how a user might actually be interacting with the system Postman

2 upvotes·2.5K views

Decision about Postman

Avatar of deeknow
Systemic Solutions ·

I use Postman across all of my stacks no matter the platform or the nature of the API being tested. The UI is excellent, the project sharing works well for teams, the built in test runner is great. The pricing is fair when it provides this much utility. A must have for team work in particular

2 upvotes·1.8K views

Decision at European Commission about Postman, Swagger UI

Avatar of Jadenko

I use Swagger UI because it's an easy tool for end-consumers to visualize and test our APIs. It focuses on that ! And it's directly embedded and delivered with the APIs. Postman's built-in tools aren't bad, but their main focus isn't the documentation and also, they are hosted outside the project.

1 upvote·2.4K views

Decision about Postman

Avatar of daherman

I chose Postman because it enables my team to quickly design and document end points for data science.

1 upvote·1.8K views