Skip to content

Instantly share code, notes, and snippets.

@glaucia86
Last active June 25, 2024 13:49
Show Gist options
  • Save glaucia86/61989fd09cdc4eec7f06c3d1b9e66804 to your computer and use it in GitHub Desktop.
Save glaucia86/61989fd09cdc4eec7f06c3d1b9e66804 to your computer and use it in GitHub Desktop.

Azure API Center: Centralizing API Management for Enhanced Discovery and Governance

teaser:


ga-apic.png

Have you ever thought about having a single place to manage all your APIs? It could make it easier to find and control your services. Azure API Center is a solution that will help you do this. It offers a single platform for creating, publishing, managing, and monitoring APIs. In this article, we will learn more about this service, its features, benefits, and how it can help you.

What is Azure API Center?

apic.png

The Azure API Center lets organizations develop and maintain a structured and organized inventory of their APIs, no matter what type, lifecycle stagem or deployment location. This centralized hub helps stakeholders - like API program managers, IT administrators, and developers - discover, reuse, and governance APIs more efficiently. By providing version details, API definition files, and common metadata, Azure API Center ensures that APIs are easily accessible and manageable.

What are the main advantages of this service? Let's dive in and take a look at few of them.

Azure API Center Benefits

  • Create and Maintain an Organizational API Inventory: Azure API Center makes it easy to create a complete inventory of all the APIs in an organization. Plus, you can get API Program Managers and Developers working together to make APIs better, safer, and more productive for everyone involved, especially developers.

  • Organization API Governance: Azure API Center lets you see all the APIs your company is using, and how they are being used. It's algo worth mentioning what we mean by custom metadata. This helps us to check that the API definitions are in line with the company's standards.

  • Easy API Discovery: This service also lets you promote the reuse of APIs to help developers work more efficiently and helps Program Managers and Developers find APIs using embedded and customized metadata.

  • Accelerate API Consumption: And last but not least, time is money. With Azure API Center, you can help Developers get their work done faster and more securely by making sure they are using APIs in line with your company's standards.

bene-apic.png

What are its main capabilities? Let's find out more.

Azure API Center Main Capabilities

Azure API Center also offers a bunch of handy features that make managing APIs a lot easier, like:

  • API Inventory Management: this lets you register all the organizations's APIs in one place.

  • Real API Representation: adding real information about each API, including OpenAPI versions and definitions. You can also list the different places your APIs are used and link them to the environments they are running in.

  • API Governance: you can organize and filter APIs using built-in and custom metadata. You can also set up linting and analysis to make sure the API definitions are top-notch.

  • API Discovery and Reuse: you can use the Azure Portal, the API Center Portal and Visual Studio Code integrated development tools like the Azure API Center Extension. This extension lets you create, discover, explore, and consume APIs directly from Visual Studio Code.

apic-extension.png

export-api.gif

Region Availability and Prices

You can get the Azure API Center in several Azure regions, including:

  • Australia East
  • Central India
  • East US
  • UK South
  • West Europe

And also, Azure API Center is offered in Free and Standard plans.

There are many other interesting aspects of Azure API Center that you can learn more about. We'll leave you with a video by Julia Kasper - Program Manager at Microsoft made during Microsoft Build 2024 talking more about the service.

Next Steps

Azure API Center is a powerful tool for centralizing and managing APIs within an organization. With all its great features and future improvements, it's going to make it easier to manage APIs, give developers a better experience, and help you keep on top of things.

So, we encourage you to check out the Azure API Center. It can help your company manage APIs more easily.

Additional Resources

If you're not familiar with this new service, we recommend you check out the new free training from Microsoft Learn on Azure API Center.

learn-training-apic.png

And, of course, if you want to learn more about Azure API Center, check out the official Azure documentation and other resources below:

There are some great examples of how you can use Azure API Center with .NET and JavaScript.

apic-portal.png

Link to the GitHub repository with examples of using Azure API Center with .NET and JavaScript: API Center Reference

And, if you're someone who likes to learn through videos, we recommend this video series on Azure API Center:

We hope you enjoyed this article and found it useful. If you have any questions or comments, feel free to share them with us.

And, until the next article. 👋🏽

@justinyoo
Copy link

@glaucia86 Thanks for writing this up! I've got a few comments for you to consider:

@juliamuiruri4
Copy link

@glaucia86 - Love the article. Again, thank you for setting aside time to work on this. Some comments:-

  • I agree with Justin's point on emphasizing more on the module throughout the article. I'm looking at the reporting dashboard, and while the module is getting some fairly 'okay' page views, the module completion rate is low, currently at 15.83%. Perhaps it would be helpful if in addition to calling out the module at the top of the article, you could also mention things like - 'Complete the module to unlock a Learn badge, and even challenge them to share it on socials after completing ...'

  • For stakeholders, the 3 personas highlighted in the module as part of the API Ecosystem in an organization are:- API Producers, API Consumers and API Platform Engineers (in place of API program managers) - perhaps you could update in the article too just for consistency?

  • Typos

    • Typo in paragraph 2 "... lifecycle, stagem >> stage or deployment location ..."
    • Typo in paragraph 2 " ... discover, reuse, and governance >> govern APIs more efficiently ..."
    • Typo in APIC Benefit item 2 " ... It's algo >> also worth mentioning what we mean by custom metadata ..."
    • Typo in APIC Capability item 1 " ... lets you register all the organizations's >> organization's APIs in one place ..."

@glaucia86
Copy link
Author

glaucia86 commented Jun 25, 2024

I finished the review! Thanks a lot @juliamuiruri4 and @justinyoo :)

p.s.: after to be published I will remove this gist ;)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment