Skip to content

Commit 3bbd267

Browse files
authored
Merge pull request #310967 from GitHubber17/543869-b
Freshness Edit: API Center
2 parents a6ad6ca + 30b54c1 commit 3bbd267

1 file changed

Lines changed: 29 additions & 31 deletions

File tree

articles/api-center/overview.md

Lines changed: 29 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,67 +1,67 @@
11
---
22
title: Azure API Center - Overview
3-
description: Introduction to key scenarios and capabilities of Azure API Center. API Center inventories an organization's APIs for discovery, reuse, and governance at scale.
3+
description: Review an introduction to key scenarios and capabilities of Azure API Center. API Center inventories an organization's APIs for discovery, reuse, and governance at scale.
44
author: dlepow
5-
65
ms.service: azure-api-center
76
ms.topic: overview
8-
ms.date: 01/06/2025
7+
ms.date: 01/28/2025
98
ms.author: danlep
109
ms.custom: references_regions
1110
---
1211

1312
# What is Azure API Center?
1413

15-
Azure API Center enables you to track all of your APIs in a centralized location for discovery, reuse, and governance. Use an API center to develop and maintain a structured and organized inventory of your organization's APIs - regardless of their type, lifecycle stage, or deployment location - along with related information such as version details, API definition files, and common metadata.
14+
Azure API Center enables you to track all your APIs in a centralized location for discovery, reuse, and governance. Use an API center to develop and maintain a structured and organized inventory of your organization's APIs - regardless of their type, lifecycle stage, or deployment location - along with related information such as version details, API definition files, and common metadata.
1615

1716
> [!TIP]
18-
> Getting started with API Center just got easier! The Free plan is now available with no time constraints. [Limits](/azure/azure-resource-manager/management/azure-subscription-service-limits?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#azure-api-center-limits) apply.
17+
> You can get started quickly with Azure API Center by taking advantage of the Free plan, which has no time constraints. Compare the [Free plan and Standard plan limits](/azure/azure-resource-manager/management/azure-subscription-service-limits?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#azure-api-center-limits).
1918
20-
By using an API center, stakeholders throughout your organization - including API program managers, IT administrators, application developers, and API developers - can design, discover, reuse, and govern APIs.
19+
By using an API center, stakeholders throughout your organization, including API program managers, IT administrators, application developers, and API developers can design, discover, reuse, and govern APIs.
2120

2221
> [!NOTE]
23-
> Azure API Center is a solution for design-time API governance and centralized API discovery. Azure also offers complementary services such as Azure API Management, a solution for runtime API governance and observability using an API gateway. [Learn more](frequently-asked-questions.yml#what-s-the-difference-between-azure-api-management-and-azure-api-center) about the differences and how Azure API Center and API Management can work together.
24-
22+
> Azure API Center is a solution for design-time API governance and centralized API discovery. Azure also offers complementary services such as Azure API Management, a solution for runtime API governance and observability by using an API gateway. [Review the differences](/azure/api-center/frequently-asked-questions#what-s-the-difference-between-azure-api-management-and-azure-api-center) and see [how they can work together](/azure/api-center/frequently-asked-questions#how-do-i-use-azure-api-center-with-my-api-management-solution).
2523
2624
## Benefits
2725

28-
* **Create and maintain an organizational inventory** - Build a **complete inventory of APIs** available in your organization. Register APIs managed in all of your API management solutions, including Azure API Management and platforms from other providers. Also include your unmanaged APIs and APIs under development. Foster communication and let API program managers and developers collaborate for increased API reuse, quality, security, compliance, and developer productivity.​
26+
Azure API Center offers the following benefits:
2927

30-
* **Govern your organization's APIs** - With more complete visibility into the APIs being developed and used within your organization, API program managers and IT administrators can govern this inventory to ensure it meets organizational standards by **defining custom metadata** and **analyzing API definitions** to enforce conformance to API style guidelines.​
28+
- **Create and maintain an organizational inventory**: Build a **complete inventory of APIs** available in your organization. Register APIs managed in all your API management solutions, including Azure API Management and platforms from other providers. Also include your unmanaged APIs and APIs under development. Foster communication and let API program managers and developers collaborate for increased API reuse, quality, security, compliance, and developer productivity.​
3129

32-
* **Easy API discovery** - Promote API reuse to maximize developer productivity and ensure developers are using the right APIs. Azure API Center helps program managers and developers discover the API inventory and filter using built-in and custom metadata.
30+
- **Govern your organization's APIs**: Access more complete visibility into the APIs being developed and used within your organization. API program managers and IT administrators can govern this inventory to ensure it meets organizational standards by **defining custom metadata** and **analyzing API definitions** to enforce conformance to API style guidelines.
3331

34-
* **Accelerate API consumption** - Maximize developer productivity when consuming APIs and ensure they are consumed in a secure manner consistent with organizational standards.
32+
- **Easy API discovery**: Promote API reuse to maximize developer productivity and ensure developers are using the right APIs. Azure API Center helps program managers and developers discover the API inventory and filter by using built-in and custom metadata. ​
3533

34+
- **Accelerate API consumption**: Maximize developer productivity when consuming APIs and ensure they're consumed in a secure manner consistent with organizational standards.
3635

3736
## Key capabilities
3837

3938
Create and use an API center for the following capabilities:
4039

41-
* **API inventory management** - API developers and API program managers can register all of your organization's APIs for inclusion in a centralized inventory by using the Azure portal, the Azure CLI, developer tooling such as CI/CD pipelines, and links to API sources such as Azure API Management services.
40+
- **API inventory management**: Enable API developers and API program managers to register all of the organization's APIs for inclusion in a centralized inventory. They can use the Azure portal, the Azure CLI, developer tooling like CI/CD pipelines, and links to API sources like Azure API Management services.
4241

43-
* **API design and development** - By using the [Azure API Center extension for Visual Studio Code](build-register-apis-vscode-extension.md), developers can register APIs directly from the same development environment where they create their APIs and apps.
42+
- **API design and development**: Allow developers to use the [Azure API Center extension for Visual Studio Code](build-register-apis-vscode-extension.md) to register APIs directly from the same development environment where they create their APIs and apps.
4443

45-
Developers can take advantage of the extension's integration with GitHub Copilot to [create API definitions from code](build-register-apis-vscode-extension.md#generate-openapi-spec-from-api-code) and with GitHub Copilot for Azure to [design APIs with AI assistance](design-api-github-copilot-azure.md).
44+
Developers can take advantage of the extension's integration with GitHub Copilot to [create API definitions from code](build-register-apis-vscode-extension.md#generate-openapi-spec-from-api-code) and GitHub Copilot for Azure to [design APIs with AI assistance](design-api-github-copilot-azure.md).
4645

47-
* **Real-world API representation** - Add real-world information about each API including versions and definitions such as OpenAPI definitions. List API deployments and associate them with runtime environments, for example, representing Azure API Management or other API management solutions.
46+
- **Real-world API representation**: Add real-world information about each API including versions and definitions such as OpenAPI definitions. Create a list of API deployments and associate them with runtime environments, for example, represent Azure API Management or other API management solutions.
4847

49-
* **API governance** - Organize and filter APIs and related resources by using built-in and custom metadata, to help with API governance and discovery by API consumers. Set up [linting and analysis](enable-managed-api-analysis-linting.md) to enforce API definition quality.
48+
- **API governance**: Organize and filter APIs and related resources by using built-in and custom metadata, to help with API governance and discovery by API consumers. Set up [linting and analysis](enable-managed-api-analysis-linting.md) to enforce API definition quality.
5049

51-
API developers can shift-left API design conformance checks into Visual Studio Code by using integrated linting support and breaking change detection. Integrate with tools such as Dev Proxy to ensure that apps don't use unregistered [shadow APIs](discover-shadow-apis-dev-proxy.md) or APIs that don't meet organizational standards.
50+
API developers can shift-left API design conformance checks into Visual Studio Code by using integrated linting support and breaking change detection. Integrate with tools such as Dev Proxy to ensure apps don't use unregistered [shadow APIs](discover-shadow-apis-dev-proxy.md) or APIs that don't meet organizational standards.
5251

53-
* **API discovery and reuse** - Enable enterprise developers and API program managers to discover APIs via an [API Center portal](set-up-api-center-portal.md). You can also enable the portal by using the [Azure API Center Visual Studio Code extension](enable-api-center-portal-vs-code-extension.md).
52+
- **API discovery and reuse**: Enable enterprise developers and API program managers to discover APIs through an [Azure API Center portal](set-up-api-center-portal.md). You can also enable the portal by using the [Azure API Center Visual Studio Code extension](enable-api-center-portal-vs-code-extension.md).
5453

5554
For more information about the entities you can manage and the capabilities in Azure API Center, see [Key concepts](key-concepts.md).
5655

5756
## Tiers and SKUs
5857

59-
API Center is also offered in a Free plan and a Standard plan. [Learn more](../azure-resource-manager/management/azure-subscription-service-limits.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#azure-api-center-limits).
58+
Azure API Center is offered in a [Free plan and Standard plan](../azure-resource-manager/management/azure-subscription-service-limits.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#azure-api-center-limits).
6059

6160
> [!NOTE]
62-
> Azure API Center is now included free with Azure API Management Premium and Standard tiers.
61+
> Azure API Center is also included free with Azure API Management Premium and Standard tiers.
6362
6463
## Available regions
64+
6565
Azure API Center is currently available in the following Azure regions:
6666

6767
* Australia East
@@ -77,22 +77,20 @@ Azure API Center is currently available in the following Azure regions:
7777

7878
Azure API Center can serve a key role in an organization's API ecosystem. Consider the hypothetical Contoso organization, which adopts an API-first strategy, emphasizing the importance of APIs in their software development and integration.
7979

80-
Contoso's API developers, app developers, API program managers, and API managers collaborate through Azure API Center to develop and use the organization's API inventory. See the following diagram and explanation.
80+
Contoso's API developers, app developers, API program managers, and API managers collaborate through Azure API Center to develop and use the organization's API inventory. The following diagram and explanation demonstrates this scenario:
8181

82-
:::image type="content" source="media/overview/api-ecosystem-example.png" alt-text="Diagram showing API Center in an example API ecosystem.":::
82+
:::image type="content" source="media/overview/api-ecosystem-example.png" border="false" alt-text="Diagram showing Azure API Center in an example API ecosystem.":::
8383

8484
Contoso's API ecosystem includes the following features:
8585

86-
* **API development** - Contoso's developers regularly build ASP.NET web APIs. They also create Azure Functions with HTTP triggers.
87-
88-
* **API deployment environments** - Contoso deploys a portion of their APIs to Azure App Service. They deploy another subset of their APIs to an Azure Function app.
86+
- **API development**: Contoso's developers regularly build ASP.NET web APIs. They also create Azure Functions with HTTP triggers.
8987

90-
* **Azure API Management** - Contoso uses the Azure [API Management](../api-management/api-management-key-concepts.md) service to manage, publish, and secure their APIs. They use separate instances for development, test, and production, each with a distinct name.
88+
- **API deployment environments**: Contoso deploys a portion of their APIs to Azure App Service. They deploy another subset of their APIs to an Azure Function app.
9189

92-
* **Azure API Center** - Contoso adopts Azure API Center as their centralized hub for API discovery, governance, and consumption. API Center serves as a structured and organized API hub that provides comprehensive information about all organizational APIs, maintaining related information including versions and associated deployments.
90+
- **Azure API Management**: Contoso uses the Azure [API Management](../api-management/api-management-key-concepts.md) service to manage, publish, and secure their APIs. They use separate instances for development, test, and production, each with a distinct name.
9391

94-
## Next steps
92+
- **Azure API Center**: Contoso adopts Azure API Center as their centralized hub for API discovery, governance, and consumption. Azure API Center serves as a structured and organized API hub that provides comprehensive information about all organizational APIs, maintaining related information including versions and associated deployments.
9593

96-
> [!div class="nextstepaction"]
97-
> [Set up your API center - portal](set-up-api-center.md)
94+
## Related content
9895

96+
- [Create your API center (Azure portal)](set-up-api-center.md)

0 commit comments

Comments
 (0)