You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/api-center/key-concepts.md
+5-2Lines changed: 5 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Key concepts of Azure API Center. API Center inventories an organiz
4
4
author: dlepow
5
5
ms.service: azure-api-center
6
6
ms.topic: conceptual
7
-
ms.date: 04/23/2024
7
+
ms.date: 11/15/2024
8
8
ms.author: danlep
9
9
---
10
10
@@ -24,7 +24,7 @@ A top-level logical entity in Azure API Center, an API represents any real-world
24
24
25
25
An API in the inventory can be managed by any API management solution, such as Azure [API Management](../api-management/api-management-key-concepts.md), Apigee API Management, Kong Konnect, MuleSoft API Management, or another platform. An API represented in Azure API Center can also be unmanaged.
26
26
27
-
The API inventory in Azure API Center is designed to be created and managed by API program managers or IT administrators.
27
+
The API inventory in Azure API Center is designed to be created and managed by API program managers or IT administrators. Azure API Center also includes features for API developers to register API definitions directly from their development environments, such as Visual Studio Code or CI/CD pipelines.
28
28
29
29
## API version
30
30
@@ -34,6 +34,8 @@ API versioning is the practice of managing changes to an API and ensuring that t
34
34
35
35
Each API version should ideally be defined by at least one definition, such as an OpenAPI definition for a REST API. Azure API Center allows any API definition file formatted as text (YAML, JSON, Markdown, and so on). You can upload OpenAPI, gRPC, GraphQL, AsyncAPI, WSDL, and WADL definitions, among others.
36
36
37
+
To help with API governance, Azure API Center provides linting capabilities to analyze API definitions for quality and compliance with organizational standards.
38
+
37
39
## Environment
38
40
39
41
An environment represents a location where an API runtime could be deployed, for example, an Azure API Management service, an Apigee API Management service, or a compute service such as a Kubernetes cluster, a Web App, or an Azure Function. Each environment is aligned with a lifecycle stage such as development, testing, staging, or production. An environment may also include information about developer portal or management interfaces.
@@ -58,4 +60,5 @@ Azure API Center's metadata schema is compatible with JSON and YAML schema speci
58
60
59
61
*[What is Azure API Center?](overview.md)
60
62
*[Metadata for API governance](metadata.md)
63
+
*[API analysis and linting](enable-managed-api-analysis-linting.md)
0 commit comments