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. Try it page not handling optional route parameters

    I have this operation in my API

    "/get/{*path}": {

            "get": {
    
    "summary": "Get",
    "description": "Gets a single file or a collection of files and folders in a ZIP archive.",
    "operationId": "get",
    "parameters": [
    {
    "name": "path",
    "in": "path",
    "required": true,
    "schema": {
    "type": ""
    }
    },
    {
    "name": "recurse",
    "in": "query",
    "description": "Retrieve files recursively or from the {path} directory only.",
    "schema": {
    "enum": [
    "true",
    "false"
    ],
    "type": "boolean"
    }
    },
    {
    "name": "pattern",
    "in": "query",
    "description": "An expression supporting asterisks as wildcards for filtering results.",
    "schema": {
    "type": "string"
    }
    }
    ],
    "requestBody": {
    "content": {}
    },
    "responses":
    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  2. Support OpenID Connect Hybrid Flow

    Currently only Implicit and Authorization Code flows are supported by the OpenID Connect provider in Azure APIM. The Implicit flow is being deprecated as vulnerable and a lot of applications are using Hybrid Flow (code id_token).

    Can you please add support for this flow?

    http://docs.identityserver.io/en/latest/topics/grant_types.html#hybrid

    7 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  3. 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
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    started  ·  43 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  4. Group, filter, and sort Products

    I propose to support Product grouping, filtering and sorting like APIs. One way that this can be implemented is by populating the tags of the products and make them available in the portal models (Views).
    Currently the available tags property is empty regardless of the attached to the products tags.
    The assignment of tags to products should also be supported in the relative Product edit interface of the azure portal.

    3 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    need-feedback  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  5. Authentication failure signing in the Developer Portal using Azure AD

    After correctly configuring Azure AD integration (as specified here https://docs.microsoft.com/en-us/azure/api-management/api-management-howto-aad) we experienced authentication failures when Azure Active Directory sign-in was selected.

    The problem happened to be with custom domain hostname for the Portal. Unless all lowercase letters are used in custom domain hostname, Azure AD sign-in doesn't work and shows message: "Authentication Failed".

    The simple solution would be to force all lower case when configuring custom domains either by converting user entered host names to lowercase or preventing users from entering caps.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  6. Support application/x-www-form-urlencoded parameters representation

    x-www-form-urlencoded parameters are currently not displayed at the developer portal. therefore the developer wont know what is expected of him to send.

    Current workaround is adding it to "sample" in the apim.
    But this is not scaling as it is a manual fix that needs to happen each time a developer uploads an openapi spec containing body parameters of this type.

    12 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  7. APIM developer cannot test post binary data via portal

    APIM developer cannot test post binary data via portal,
    but it's a must to post files like wav, png, jpg and etc..

    4 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  8. Allow scopes to be added to OIDC token request when testing APIs in the Developer Portal

    Scopes are commonly used to authorize requests to API operations and the current JWT policies allow scopes to be used for this.
    However, if an API uses scopes to authorize access then these APIs cannot be tested via the Developer Portal because there is no way to add resource scopes to the token request made by the portal on the developer's behalf.

    7 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  9. Open Id Connect - add required scopes in Developer Portal

    Currently it is not possible to add required scopes (or any additional URL or body parameters) to authorize requests.
    I think it is possible for OAuth0 integration.
    It might be worthwhile to add such possibility.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  10. Save data when testing API

    It would be awesome and saves time if API Management saves data history that is being used to test API

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    triaged  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  11. Improve C# code sample template for PATCH operations

    Currently, the C# code sample template doesn't have a case for PATCH operations (other Http methods are listed). Would be good to fix this gap in the interest of completeness.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  12. Render placeholders for request headers in sample code templates

    The code samples in the developer portal (curl, c#, java, etc.) do not render a placeholder value for request header parameters, aside from a few special ones like subscription key, authorization, content-type, etc. I can fix this in the Liquid template, but this might be a good improvement for APIM out of the box.

    For example, if I have the following required header parameter defined in my OpenApi definition for a PATCH request:
    {
    "name": "If-Match",
    "in": "header",
    "description": " ETag of the entity",
    "required": true,
    "type": "string"
    }

    The Curl code sample renders this header without any {placeholder} value…

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  13. allow developer/management portal access from region close to developer.

    For a premium tier multi region setup, allow developer/management portal access from region close to developer. Or allow to make other unit as primary so that developers can still access portals in case they have issues accessing primary unit which hosts all portals

    4 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  14. Multi-brand support in Developer portal

    Multi-brand support in Developer portal

    6 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  15. 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…

    8 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  16. Customize redirection from signin/signup page to Home page instead of profile

    Currently when a user signs up from the Developer Portal and then signs in, the user is taken to the Profile page. It would be more presentable and better user experience if there is an option to redirect the user to the Home page upon log in than to the Profile page.

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

    18 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  18. Search API across entire site

    It would be very useful to have the search button functionality on entire site. For example, when searching an API by a word to display all related results from all available pages.

    6 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  19. Embed Azure DeveloperPortal in a corporate domain site

    The developer portal enables us to import APIs and run them. I would like to be able to embed it into an existing corporate site that is already describing our company, our products, even some APIs documentation in order to have the possibility to run the APIs from there. In this way, we will decrease the number of websites a customer must use in order to access all of our features. It can be annoying to have a website for the company and then another website just for running APIs and then maybe another website for something else, etc.

    5 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →

    We are planning to address this issue as part of our developer portal work.


    Thanks for the feedback. Even though it’s possible to embed API Management developer portal experience into another portal in the true sense, it’s possible to integrate it with another portal for a more seamless experience using delegation – see docs.microsoft.com/en-us/azure/api-manageme…

  20. stop forced display of Request Headers

    Hello.
    When adding the "CONTENT TYPE" of Request Body's Representations in the publisher portal, Request Headers is forcibly displayed as "Content-Type (optional)" on the developer portal, so it is in a state that it can not be deleted or edited.
    I want you to stop forced display of Request Headers or make it editable.
    Thank you.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  • Don't see your idea?

Feedback and Knowledge Base