Import an OpenAPI specification
This article shows how to import an "OpenAPI specification" back-end API residing at https://conferenceapi.azurewebsites.net?format=json. This back-end API is provided by Microsoft and hosted on Azure. The article also shows how to test the APIM API.
In this article, you learn how to:
- Import an "OpenAPI specification" back-end API
- Test the API in the Azure portal
- Test the API in the Developer portal
Prerequisites
Complete the following quickstart: Create an Azure API Management instance
Go to your API Management instance
In the Azure portal, search for and select API Management services.
On the API Management services page, select your API Management instance.
Import and publish a back-end API
Navigate to your API Management service in the Azure portal and select APIs from the menu.
Select OpenAPI specification from the Add a new API list.
Enter API settings. You can set the values during creation or configure them later by going to the Settings tab. The settings are explained in the Import and publish your first API tutorial.
Select Create.
Note
The API import limitations are documented in another article.
Append other APIs
An API can be composed of APIs exposed by different services, including the OpenAPI Specification, a SOAP API, the API Apps feature of Azure App Service, Azure Function App, Azure Logic Apps, and Azure Service Fabric.
To append a different API to your existing API, complete the following steps. When you import another API, the operations are appended to your current API.
- Go to your Azure API Management instance in the Azure portal.
- Select APIs from the menu on the left.
- Click ... next to the API that you want to append another API to.
- Select Import from the drop-down menu.
- Select a service from which to import an API.
Related topics
- API import limitations
- Import an OpenAPI Specification
- Import a SOAP API
- Import a SOAP API and convert to REST
- Import an Azure API app
- Import an Azure Function App
- Import an Azure Logic App
- Import a Service Fabric service
- Edit an API