When working with APIs, it’s typical that you use Postman to test your rest services. However, for your projects to be seamless, you need to have a means of sharing your requests with your teams. And for you to share the requests, you need to group them in a collection for efficiency. Since we had a blog detailing the process of creating a Postman collection, in this piece, we’ll discuss the various ways that you can share a collection in Postman.
Contents
Postman offers developers a plethora of ways for them to share collections with their collaborators. It allows you to share collections with your workspace team or send a link that can allow your employees or even individuals that are not part of your workspace team to access a collection. Here is how you share collection in Postman.
From the Sidebar
Visit your postman app and scroll to the collection tab in the sidebar. Click on the tab and look for the ellipsis icon (…). Hit the ellipsis to extend the view.
Once you hit the ellipsis, it will extend, displaying the share collection icon. Hit the share collection tab to move to the next step.
Using the Browser Option
1. Switch to Browser Option
If you want to use the browser option, hit the Browse button positioned on the bottom right corner, as displayed in the image below.
2. Hit the collections tab
You’ll have all collections displayed in a window for you to choose the one you want to share.
Whether you use the sidebar or the browser option, once you hit the share collection button, a new window with three options will pop-up, as illustrated by the image below.
This means that developers can share collection in three ways:
- Sharing to a workspace
- Sharing via the Embed
- Sharing with a public link
With this option, developers can share collections with members of their workspace. When you use this option, the API requests in the collection will be available to every team member. The best thing is that once the collection is shared, you can still alter the permission granted to it and allow members to edit the collection, read-only, or vice-versa.
Sharing via the Embed
This option allows you to share a collection by generating a code that helps you create a link that you can share with your teams. Here, you’ll find two handy buttons. The “Generate Code” button helps you create a link. The link is then shared when you click the “Run in Postman” button. The link is embedded in your API documentation, website, or GitHub readme, where everyone within your organization can import and run the collection with a single click.
However, it essential to note that links already shared will not be updated automatically when there is a change in the collection. As such, developers should generate and share a new link once they make new changes to a Postman collection.
Conclusion
If you’ve been struggling to share your API requests with your team members, we bet you can now do it within the shortest time possible. You just need to group your requests into a collection and use the intuitive Postman Share Collection button to ensure that your workers or teammates get the requests on time.
How to convert a Postman Collection to OpenAPI using APITransform
When working with Postman, you may sometimes be required to convert postman collection to OpenAPI for more comfortable use. APITransform is a free online resource that allows programmers and developers to convert postman collections to OpenAPI specifications in a few steps. Here is how you do it:
- Search for https://apitransform.com and hit the “Upload Postman Collection” button on the dashboard.
- Fill in the required credentials before you start converting your Postman collections. Here, you’ll be required to fill in your first & last name, email, name of your company.
- Upload the Postman Collection file and convert it.
- Download the converted file from the link that will appear after some minutes
- Now you can go ahead and add your API to the RapidAPI Marketplace.