The new, open-source API Management developer portal is now generally available. It delights the consumers of your APIs with a carefully redesigned modern look and feel and unlocks new scenarios such as automation or custom extension of the functionality. The Azure documentation article contains instructions on how to get started.

What’s different in the new portal?

Better performance, scalability, and security—The new portal has been completely reengineered for simplicity, performance gains, and scalable distribution. It has a lightweight architecture and uses JAMstack technology.

Modern look out-of-the-box—The default theme will help impress the consumers of your APIs and minimize the need for customizations. The new pages and widgets have been carefully designed and optimized for usability, accessibility, and an elevated user experience.

Customizations through the visual editor—The portal features a special panel for designers to control all styling from a centralized location. Content editors can modify the pages through a drag-and-drop editor.

Open source—You can observe, audit, fork, or contribute to the project on GitHub.

Extensibility—The portal comes built into every API Management instance (excluding the Consumption tier). If you wish to extend the portal’s core functionality (for example, create your own widgets to fetch data from other sources), fork the GitHub repository, implement the code changes, and self-host your own modified version of the portal.

Dev-Ops—A set of new APIs let you automate portal’s deployments, migrate content and configuration, or perform or restore backups.

How to start using the new portal

The Azure documentation article clarifies the differences between managed and self-hosted portals and explains how to get started.

What’s coming next

In the next few weeks we will be adding support for OAuth authentication in the interactive console as well as an ability to filter APIs and API operations by tags. The roadmap is publicly available through Projects on GitHub.

Bug reports can be raised through GitHub Issues, support requested on Stack Overflow or through Azure support, and feature asks submitted through Azure Feedback Forum.

Old developer and publisher portals are now in legacy mode

With the general availability of the new portal, the old developer and publisher portals have become legacy features – from now on they will be receiving security updates only. New features will be implemented in the new developer portal only. Deprecation of the legacy developer and publisher portals will be announced separately. If you have concerns, questions, or comments, voice them in a dedicated GitHub Issue.

You can find more information on the new developer portal in the Azure documentation article.

Learn more