Update: Microsoft will be moving away from UserVoice sites on a product-by-product basis throughout the 2021 calendar year. We will leverage 1st party solutions for customer feedback. Learn more here.

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.

  • Hot ideas
  • Top ideas
  • New ideas
  • My feedback
  1. 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.

    23 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  2. Multi-brand support in Developer portal

    Multi-brand support in Developer portal

    22 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  3. Support typed array parameter schema

    Currently, only simple parameter types are shown in the developer portal and any complex schema information included in the OpenApi document uploaded to APIM will be lost when downloading the OpenApi document from APIM.

    For example, I have the following parameter that I am uploading to APIM:

    {
        “name“: “fields“,
        “in“: “query“,
        “description“: “Represents a list of fields to include on the returned records.“,
        “style“: “form“,
        “explode“: false,
        “schema“: {
            “type“: “array“,
            “items“: {
                “enum“: [
                    “id“,
                    “constituent_id“,
                    “name“,
                    “phone“,
                    “email“,
                    “participation_level“,
                    “attended“,
                    “rsvp_status“,
                    “invitation_status“,
                    “rsvp_date“,
                    “total_registration_fees“,
                    “total_paid“,
                    “host“,
                    “guests“,
                    “name_tag“,
                    “seat“,
                    “memberships“,
                    “lookup_id“,
                    “is_constituent“,
                    “date_added“,
                    “date_modified“
                ],
                “type“: “string“
    21 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  4. Filtering APIs and operations based on tags

    1. 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 … )

    2. Is it possible not to see the tags defined for APIs into the operation page while trying to filter…

    21 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  5. Easy backup and restore of developer portal on it's own and separately from APIM backup

    Hi, I would like to see a feature that makes it easy to back up and restore (maybe versioning) the developer portal. I can see this as simply another tab within the APIM blade.

    This is because we hand that to the company UI designer and we recently lost custom style changes due to a bug whereby deleting a button caused the site to go into a non-fixable state. But this feature would be useful in any case.

    20 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    2 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  6. [New Developer Portal] : Widget to add HTML tables and list

    Our documentation contains lot of tables and list and since the new developer portal doesn’t have this functionality it block us from content migration.

    19 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  7. 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.

    18 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  8. Provide named values to the templates

    Would it be very useful if "named values" (global parameters you can use inside policies) could be used inside dotliquid templates ie.

    {{ myCustomNamedValue }}. This is important to link to external resources (in development / production envs), or to display values to the users (ie. quota limits) you use in policies as well.

    16 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  9. 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
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  10. New Portal - Ability to expand 'object' and 'object[]' to see nested fields

    With the currently developer portal when you're viewing an API endpoint, you are only seeing the parent fields, so if something is nested or an array, you're only seeing the top level. See the attached screenshot.
    We would like to be able to expand the object or array to see the fields contained within as well.

    15 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  11. Developers to assign individual keys to their applications

    Right now keys are issued to developers as per product subscriptions. There is no way to identify which applications are using a particular API. It can only show developer usage statistics. Some developers might lose track of their own applications especially if they are internal developers so a mechanism to identify the application using an API based on a key would be great.

    14 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  2 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  12. Disable or unpublish the new Developer portal

    Could you please provide a feature to disable (unpublish) the new Developer portal for users who do not want to publish the developer portal.
    - The feature to switch to disable the developer portal after publish the developer portal

    I think we cannot unpublish the new developer portal once we make it publish state.

    14 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  13. Add "Remember Me" feature to OAuth Resource Owner Password grant type in the Developer Portal

    Add a "remember me" checkbox to the OAuth Resource Owner Password grant type so that it reuses the access token for other "Try It" attempts for any other API operations instead of requiring the username/password for every operation.

    13 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  14. Keep track of mail send by APIM

    Today it is impossible to had a "guarantee" that APIM send an email to users, we could only get those emails in BCC. But this is not enough due that if APIM mail system failed for any reason, no one receive email and Azure support team can't help on that today.

    13 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  15. Full-text search that covers all web pages of the DevPortal

    To enable all users/visitors of the DevPortal to search for key terms, the DevPortal shall
    - provide a google-like full-text search function that searches in all pages of the DevPortal including the meta data for each page
    - For each page, meta data can be entered (e.g. synonyms) to improve the search results
    - provide a web widget with a customizable search field that can be easily added on pages and layouts/templates on any place.
    - offer options on how to display the search results, e.g., on the same page, in a new window, or in a new browser tab…

    12 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  16. Rename subscription key header details (description, value)

    I’ve already modified the header name to ‘api-key’. Now trying to figure out if I can customize APIM template data values for header description and value.

    The challenge is that the existing values still refer to the subscription key as 'subscription key' so the documentation and code samples based on the template data (see attached) become confusing once the subscription key is renamed.

    12 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  17. Add x-www-form-urlencoded view when editing a request body

    URL encoding is essential when sending requests to some endpoints (e.g. OAuth2.0 token endpoint). Postman has a very useful view (x-www-form-urlencoded) to enter parameters that need to be URL encoded in the request body.

    A similar view could be implemented by adding a new www-form-urlencoded option beside the "raw" and "binary" options when editing the body of a request in the developer portal.

    12 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  18. enable relative link between APIs

    I want to be able to cross-link APIs published in the portal.
    For example, the description of API1 could say
    see also this API2 for an alternative <link to API2>
    Currently i can link API2 like this:
    see also this API2
    This enhancement request would be to have a way to not hardcode contoso.developer.azure-api.net (i.e. a full url), but instead have a way to only specify a relative link, so that if APIM is deployed under a different root domain, all the links still work correctly.

    11 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  19. Host and manage API documentation that is easy to edit, publish and manage

    As today, we do not have a simple way to publish documents (PDFs, Excel, etc..) in the developer portal.

    We would like to have a way to publish public documents, documents shared across products, product-related documents and api-related documents.
    Some of this content is managed by the API analyst, other is managed by the API PM and they want to manage the content indipendently from the release pipeline of an API.

    It would be nice to have a blob container per scenario (public, private, per product, per api) and the developer portal takes care to render the content of the…

    11 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  20. Search for Operation in API not available in Azure API Management developer portal

    Search for Operation in API not available in Azure API Management developer portal

    Search for Operation in API not available in Azure API Management developer portal

    Where as with Administrator portal same search feature available for operation search

    The problem is when we provide link to customers, they are not able to search based on some specific word. They need to scroll till they find the specific operation.

    This is not user friendly.

    10 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  • Don't see your idea?

Feedback and Knowledge Base