Microsoft's Azure API management, which is used to publish APIs for internal and external developers, now supports previewing of the latest OpenAPI Specification v3 standards, providing developers with more tools for creating and maintaining sharing their necessary APIs.
Mike Budzynski, Program Manager for Azure Integration Services, announced support for previewing the latest specification in a recent release of Microsoft Azure Blog.
OpenAPI Specification v3 is the latest version of the open source standard widely used to describe APIs, writes Budzynski. The implementation of this feature is based on the OpenAPI.NET SDK.
The OpenAPI specification is so far supported by around 30 companies, including Microsoft, as a widely adopted industry standard for software API creation, he wrote. "[The] The OpenAPI specification allows you to abstract your APIs from their implementation, making them portable and easy to adapt for other purposes.
The language-independent API definitions are easy to understand and are represented in YAML or JSON files to be readable by humans and machines, Budzynski explained.
"The large-scale adoption of the OpenAPI specification has resulted in the creation of an extensive tools ecosystem", which allows developers to collaborate on API designs, to automatically generate client development kits and create server implementations in common programming languages, he wrote.
The APIs defined in an OpenAPI specification file can be easily imported into Azure API Management, which is one of the benefits of using the specification. The Azure portal automatically recognizes the correct version of the OpenAPI specification files, which can then be imported as needed. APIs can also be imported with the help of the REST API call, he wrote.
Azure API management tools can also be used to export APIs in OpenAPI Specification v3 format. The API specifications can be downloaded from a developer portal as JSON or YAML files. Users can discover APIs, learn how to use them, try them interactively and register to acquire API keys using the development portal.
Developers can also choose to export the specs via the Azure portal's visual interface or a REST API call, if necessary, Budzynski wrote.
To try the latest features of the new specifications, developers can now import their APIs from OpenAPI specification files and perform a test, he wrote. "Before the feature is available, we will implement the JSON export via a REST API call.In the coming months, we will also add support for import and export. of the OpenAPI Specification v3 export in the PowerShell SDK. "
The OpenAPI specification is an open community-driven specification within the OpenAPI initiative, which is a collaborative project of the Open Source Linux Foundation. The OpenAPI specification defines a standard interface description, independent of the programming language, for REST APIs, which allows users and computers to discover and understand the functionality of a service without requiring access to source code. additional documentation or inspection of network traffic. group.
Azure API Management provides the essential skills to ensure API creation through developer engagement, business information, analysis, security and protection, according to Microsoft. It can be used to take any server and launch a complete API program based on it.