Import an OpenAPI specification

• 11/22/2017
• 4 minutes to read
• Contributors
  • 
  • 
  • 
  • 
  • 

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:

Prerequisites

Complete the following quickstart: Create an Azure API Management instance

Go to your API Management instance

1. Sign in to the Azure portal.

2. Select All services.

3. In the search box, enter api management.

4. In the search results, select API Management services.

5. Select your API Management service instance.

Import and publish a back-end API

1. Select APIs from under API MANAGEMENT.
2. Select OpenAPI specification from the Add a new API list.

3. Enter appropriate settings. You can set all the API values during creation. Alternately, you can set some of them later by going to the Settings tab.
   If you press tab some (or all) of the fields get filled up with the info from the specified back-end service.

   

   Setting	Value	Description
   OpenAPI Specification	https://conferenceapi.azurewebsites.net?format=json	References the service implementing the API. API management forwards requests to this address.
   Display name	Demo Conference API	If you press tab after entering the service URL, APIM will fill out this field based on what is in the json. This name is displayed in the Developer portal.
   Name	demo-conference-api	Provides a unique name for the API. If you press tab after entering the service URL, APIM will fill out this field based on what is in the json.
   Description	Provide an optional description of the API.	If you press tab after entering the service URL, APIM will fill out this field based on what is in the json.
   API URL suffix	conference	The suffix is appended to the base URL for the API management service. API Management distinguishes APIs by their suffix and therefore the suffix must be unique for every API for a given publisher.
   URL scheme	HTTPS	Determines which protocols can be used to access the API.
   Products	Unlimited	Publish the API by associating the API with a product. To optionally add this new API to a product, type the product name. This step can be repeated multiple times to add the API to multiple products. Products are associations of one or more APIs. You can include a number of APIs and offer them to developers through the developer portal. Developers must first subscribe to a product to get access to the API. When they subscribe, they get a subscription key that is good for any API in that product. If you created the APIM instance, you are an administrator already, so you are subscribed to every product by default. By default, each API Management instance comes with two sample products: Starter and Unlimited.

4. Select Create.

Test the new APIM API in the Azure portal

Operations can be called directly from the Azure portal, which provides a convenient way to view and test the operations of an API.

1. Select the API you created in the previous step.
2. Press the Test tab.

3. Click on GetSpeakers.

   The page displays fields for query parameters but in this case we don't have any. The page also displays fields for the headers. One of the headers is "Ocp-Apim-Subscription-Key", for the subscription key of the product that is associated with this API. If you created the APIM instance, you are an administrator already, so the key is filled in automatically.

4. Press Send.

   Backend responds with 200 OK and some data.

Call an operation from the Developer portal

Operations can also be called Developer portal to test APIs.

1. Select the API you created in the "Import and publish a back-end API" step.

2. Press Developer portal.

   

   The "Developer portal" site opens up.

3. Select API.
4. Select Demo Conference API.

5. Click GetSpeakers.

   The page displays fields for query parameters but in this case we don't have any. The page also displays fields for the headers. One of the headers is "Ocp-Apim-Subscription-Key", for the subscription key of the product that is associated with this API. If you created the APIM instance, you are an administrator already, so the key is filled in automatically.

6. Press Try it.

7. Press Send.

   After an operation is invoked, the developer portal displays the Response status, the Response headers, and any Response content.

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.

1. Go to your Azure API Management instance in the Azure portal.
2. Select APIs from the menu on the left.
3. Click ... next to the API that you want to append another API to.
4. Select Import from the drop-down menu.
5. Select a service from which to import an API.

Related topics

• 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

Next steps