Skip to content

Commit 8598c18

Browse files
Merge pull request #276100 from dlepow/patch-290
[APIM] Update import-app-service-as-api.md
2 parents 4e99895 + 592317d commit 8598c18

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

articles/api-management/import-app-service-as-api.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,15 @@ API Management is the recommended environment to expose a Web App-hosted API, fo
3838

3939
For more information, see [About API Management](api-management-key-concepts.md).
4040

41-
## OpenAPI specification versus wildcard operations
41+
## OpenAPI definition versus wildcard operations
4242

43-
API Management supports import of Web Apps hosted in App Service that include an OpenAPI specification (Swagger definition). However, an OpenAPI specification isn't required.
43+
API Management supports import of Web Apps hosted in App Service that include an OpenAPI definition (Swagger definition). However, an OpenAPI definition isn't required.
4444

45-
* If the Web App has an OpenAPI specification configured in an API definition, API Management creates API operations that map directly to the definition, including required paths, parameters, and response types.
45+
* If the Web App is configured with an OpenAPI definition, API Management will detect that. Alternatively, you can [manually import the definition](import-api-from-oas.md) to API Management. API Management then creates API operations that map directly to the definition, including required paths, parameters, and response types.
4646

47-
Having an OpenAPI specification is recommended, because the API is imported to API Management with high fidelity, giving you flexibility to validate, manage, secure, and update configurations for each operation separately.
47+
Having an OpenAPI definition is recommended, because the API is imported to API Management with high fidelity, giving you flexibility to validate, manage, secure, and update configurations for each operation separately.
4848

49-
* If an OpenAPI specification isn't provided, API Management generates [wildcard operations](add-api-manually.md#add-and-test-a-wildcard-operation) for the common HTTP verbs (GET, PUT, and so on). Append a required path or parameters to a wildcard operation to pass an API request through to the backend API.
49+
* If an OpenAPI definition isn't provided, API Management generates [wildcard operations](add-api-manually.md#add-and-test-a-wildcard-operation) for the common HTTP verbs (GET, PUT, and so on). Append a required path or parameters to a wildcard operation to pass an API request through to the backend API.
5050

5151
With wildcard operations, you can still take advantage of the same API Management features, but operations aren't defined at the same level of detail by default. In either case, you can [edit](edit-api.md) or [add](add-api-manually.md) operations to the imported API.
5252

0 commit comments

Comments
 (0)