API Management
Microsoft Azure API Management is a turnkey solution for publishing APIs to external and internal consumers. Quickly create consistent and modern API gateways for existing backend services hosted anywhere, secure and protect them from abuse and overuse, and gain insights into usage and health. Plus, automate and scale developer onboarding to help get your API program up and running in no time.
-
GraphQL introspective support within API Management
Like swagger documents which describe REST endpoints, we would like to surface graphql queries and mutable schemas and types through the Developer portal.
470 votes -
New API Management developer portal
We are working on a new, open-source developer portal offering in Azure API Management, based on our own fork of the Paperbits framework (paperbits.io). It has a modern default look and feel, and is optimized for:
Customization, styling, and authoring through a built-in visual editor
Programmatic access through APIs for automating development, management, and deployment
Extension of the provided core functionality
376 votes -
API / Operation visibility
Make possible to manage the visibility not only at product level but also at API level (and even maybe at operation level)
374 votes -
Controlling Signup button functionality
Currently there is no support to disable Signup functionality. If we disable Identities, it disables the Login also.
There must be a way to achieve this. Refer below link for more details:
93 votes -
Ability to Group Subscription Keys
Currently the subscription keys are issued at the 'Product' level. These products basically map to resource features. It is great that subscription is managed at this granularity but it would be better if the subscriptions can also be managed at higher levels. I may want to use the same subscription key to Axcess multiple products (or bundles) or even go to a higher level of managing APIs at multiple bundles level (or container) with a single key. This way the developers can use the same subscription key across products, bundles or container levels as configured by the publisher of the…
83 votes -
Single Swagger file for all APIs
Support producing/exporting a single Swagger file for all APIs within API management.
78 votes -
Manual order/grouping of operations
It'd be great to be able to manually order and/or group operations within an API for easier usage.
53 votesThanks for the feedback. Can you please provide a little more details on how you want this to work? Do you want this feature on developer portal or admin portal or both? Thanks!
-
Support in "produces" section the Accept-Header from OpenAPI specification
The produces/consumes is MIME type.
1. The “consumes” specify the format that the API can accept. So “consumes” only affects operations with a request body, such as POST, PUT and PATCH.
And is sent via “Content-Type” header
2. The “produces” specify the format that the API can return.
And I sent via “Accept” headerUsing the “Accept” header the user can select needed API response MIME type (e.g. "text/plain", "application/octet-stream", "/").
When sending a request with SwaggerUI, We can selecte "application/octet-stream" Response Content Type.
The request was sent by Swagger UI with the “Accept” header value filled "application/octet-stream".…
51 votesPlease upload an OpenAPI file illustrating the issue.
-
Support better grouping & sorting of products & APIs
Right now - everything is forced into alphabetical sorting. There are no grouping options. We plan to use this for our entire enterprise, and we expect to end up with hundreds of APIs and dozens of products. A simple "sort order" field will accomplish the sorting issues, may be cumbersome to maintain but we could manage. Not sure how grouping would work, but here is our example:
Products:
Business Unit A - Developer
Business Unit A - Test
Business Unit A - Production
Business Unit A - Production UnlimitedI may like to have a "bucket" named just "Business Unit…
44 votesGrouping is now available for APIs and operations. We plan to add same functionality to products too.
-
Support for multi-tenant user login delegation
In a multi-tenant scenario, there is no option to delegate user login to multiple urls, the delegation section allows only one url.
It would be great if it would allow one delegation endpoint per custom developer portal domain.
39 votesHi, can you please provide more information about your scenario? Thanks.
-
Client certificate authentication in developer console
If the front-end takes mutual certs, the console cannot provide a way for developers to test API.
35 votes -
Set custom domain name for the new Developer Portal
When running API Management in Internal vNet mode it is not possible to access the Developer Portal over <your-api-management-instance-name>.developer.azure-api.net since it's not publicly accessible. We need to be able to set a custom domain name on the new portal, can you please add the new portal to the list of endpoints available for custom domain names.
30 votesWe’re planning to provide full support around general availability of the portal.
-
Send an email to a user once their subscription has been activated
When a developer subscribes to a product that requires activation, they're not currently notified when their subscription is approved.
28 votes -
Ability to Secure New Developer Portal Pages
In the new developer portal there is no way to secure pages from being viewed. If i want to add supplementary api documentation pages in the portal I cannot specify to only allow that page to show when the user is logged in. The only real security in the portal is that apis and products won't show based on whether the user is logged in.
The only capability present is to hide them in the navigation menu. So if I add a page at /apis/project/order. I can place it in the menu and say whether it will show up there,…
28 votes -
Register app with Azure AD through developer portal
Given that there are already integrations with Azure AD, it would be developer friendly if you could register and manage your apps with Azure AD through the developer console.
That way you would need just one portal to deal with things like client ids, secrets etc
27 votes -
API change log with notifications
Automatically provide a change log per API & operation when changes are made to the API (including full replacement via Swagger). Also have the ability to send developers with subscriptions to products linked to an API an e-mail with change notifications on time-scale they choose (daily, weekly) or when pushed by admin.
23 votes -
Filtering APIs and operations based on tags
Is it possible to see on the APIs page, while trying to filter based on tags, just the tags correspondent to the APIs and not also the tags defined for operations? (If an user of the API portal will want to filter the APIs it will be difficult to choose a proper tag value because there are, for example, more than 30 tags into the drop down and the actual tags for the APIs are for example just 4-5 … )
Is it possible not to see the tags defined for APIs into the operation page while trying to filter…
18 votesThanks for the feedback. We will improve the user experience when there is a large number of tags defined.
-
Display description included in JSON schema
It's great that we are able to provide JSON schema for request definitions. As we are using the "description" property in our request schema to give some useful hints regarding each property, it would be nice to have this shown in the developer portal (like it is done in the "Model" view of swagger UI). Currently the descriptions are a bit hidden in the schema definition and not so obvious for the developers.
19 votes -
API Management Swagger Definition does not give model details.
I have imported swagger definiton file into APIM Publisher portal. It shows different actions but there is no info about navigation property from an entity which is specified in the Entity Framework model. I would want to publish that information on developer portal as well. See the attached picture.
15 votesHi, the picture seems to have been lost, can you please resend?
-
Developer-facing UX for Basic Auth credentials
Today, APIM provides a nice developer-facing UX for acquiring OAuth 2.0 access tokens – specifically, a dropdown is rendered on the Console page with whatever supported grant types have been selected for the Authorization Server associated with the API.
But for APIs that use a Basic Authentication security model for user-level authorization, there is no similar developer-facing UX. So this means that developers using the portal have to manually click “Add header”, select “Authorization”, and then specify the base-64 encoded value for their username:password. That works fine, but it’s a little cumbersome.
It would be nice if APIM could provide…
15 votes
- Don't see your idea?