Hi guys,
Postman founder here! We are super excited about the button. It helps bridge a huge gap between public API documentation systems and developers. No more copy/pasting curl commands! The response from our partners has been awesome so far. We are hearing from tons of other public API publishers who are implementing the button for their docs. It's super simple to embed the button and is available for both HTML + JS and Markdown generated docs. Happy to answer questions. :)
Thanks for the Apigee shoutout in the blog announcement, Priyanka. Love the convenience of importing and running collections-- the developers (and ultimately everyone) win!
I've been a user of Postman for local testing for some time. This is a neat application for it that I hadn't thought of. For people who aren't already using Postman, what's the advantage of this over just links or curl snippets in your documentation?
@jdemorrow Hi Jason! When you say this, do you mean the Run button? We provide the web view so people who don't have Postman can get access to the collection. Using it in Postman is a lot faster than setting up cURL commands and what not. And we hope people will notice that ;-)
@jdemorrow Along with manual testing of endpoints like curl, Postman also allows you to construct workflows by connecting and transferring data between requests. It has a testing suite that you can eventually use to run your integration tests. The Run button lets you import these workflows/tests quickly.
Absolutely essential for API docs. We added postman buttons to the blueprint reference docs on our website for the Sails framework and it's been killer so far. Super pumped to see this on more API docs for the next time I'm on the integrating side :)
As someone currently working on a few API-based projects, I love this idea. I do wonder how many of my users will use Postman though - Maybe the friction to access the Postman webview could be worked on?
@nilefrater That's a great point, thanks Nile. One thing to keep in mind is 3M+ devs have used Postman and a huge number sign up every day. A lot of our enterprise partners are excited to implement the button because devs in their organizations and people they know use Postman. That said, totally hear you on making the web view better!
We get this question all the time from developers, "how can I start using your Management API with Postman?". At Apigee, we added it to the Github repo and Run in Postman Button makes it dead simple. Developers love it! Keep up making API development easy for developers. It's a noble mission!
Postman