![]() This approach saved me several working hours on the task of exposing the Partner API in my API Management Portal.Last week while doomscrolling (as you do), I saw Phil Topness's tweet of a Power Automate custom connector 'Import a Postman collection' function screenshot. It probably doesn’t do everything for you, you may need to optimize the query parameters or the URL template parameters, but at least this approach will do 90% of the work for you: Import the file I had created previously in the APIMATIC web tool and click “Create”.From the left pane, select “Add API” and then select “OpenAPI specification” option. ![]() Now that I have my swagger file, I can now access my API Management in the Azure Portal and then: The output file will be automatically downloaded into your machine. And select the desired output format, in our case we selected “Swagger v2.0 (JSON)”.Upload your Postman collection file description.So, how can I import a Postman collection into my Azure API Management?įortunately for us, there are several free tools that allow you to convert (or transform) a postman collection (1.0 – 2.0) to formats of your choice that in our case Swagger. and the API Management by default doesn’t allow me to import a Postman Collection.I didn’t want to replicate or manually expose the API inside the API Management….I have to say, I love Postman but I never used it for that propose, although it is an excellent tool, in my opinion, I believe that to document an API it has some limitations.Īnd in one of my recent projects the partner delivered me a Postman Collection as a way of documenting their REST API which led me to a “small” problem: See how to create a Postman Collection here: Creating collections Using scripts, you can build integration test suites, pass data between API requests, and build workflows that mirror your actual use case of APIs. ![]() Postman Collections are groups of requests that can be run together as a series of requests, against a corresponding environment. Performing unit tests in all the operations and sharing them inside their teams. This specification is widely used these days, especially in the Microsoft community, but unfortunately, not all of them use it and there are still quite a few APIs that do not expose any kind of specification/documentation like Swagger, WADL or even WSDL (this last for web services).įor REST APIs, I have seen several suppliers/partners use Postman Collections to easily test their APIs by emulating request but also to document the APIs by adding a name and descriptions to requests, sample requests, headers, and other metadata. The format is easy to learn and is both human-readable and machine-readable. Contact information, license, terms of use and other information.ĪPI specifications can be written in YAML or JSON.Operation parameters Input and output for each operation.Available endpoints (/users) and operations on each endpoint (GET /users, POST /users). ![]() An OpenAPI file allows you to describe your entire API, including: OpenAPI Specification (formerly Swagger Specification) is an API description format for REST APIs. I also delivered several API Management talks here in Portugal but I realize that I never wrote a blog post about this topic. I have been working with API Management (APIM) for a long time, not only playing around with POC and testing new features but actually working and implementing real solutions for clients. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |