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 OpenAPI 3.0 callbacks in Developer Portal

    The operations page does not display details of "Callbacks" section included in Open API 3.0:
    https://swagger.io/docs/specification/callbacks/

    Please could any callbacks defined against an operation be displayed in the new developer portal, in a similar way to Swagger UI

    3 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 →
  2. 3 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. 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.

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

    21 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 →
  5. Fix unusable slowness for moderately sized SOAP pass through APIs

    Also posted here:
    https://social.msdn.microsoft.com/Forums/en-US/974a3b37-32bc-4544-bd55-c6bd3c3b4cc9/why-does-azure-apim-developer-portal-hang-for-moderately-sized-soap-pass-through-apis?forum=azureapimgmt&prof=required

    I've created a SOAP pass through API using a WSDL from Workday, which contains about 20 or so operations. The generated request samples produced by APIM upon import I suppose are somewhat large. However when I go to the developer portal and click on one of these APIs to test it the portal hangs, sometimes indefinitely. It appears as thought size of the API (number of operations and size of the XML request examples?) causes some strange performance issue. It really makes this product unusable for me at the moment, which is unfortunate.

    3 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 →
  6. 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 →
  7. Add AD Rules to Users and Groups Management

    When new users authenticate in the Developer portal they are automatically added to the system group - Developers. But for product visibility purposes, we have additional user defined groups: Internal and External (I'm sure there are other use cases, that's just ours). We move those users who authenticate by AD into the Internal group and those who don't into External. This is a manual process. If we could add an 'AD like' rule to the Developers group memberships on add that automatically (based on authentication method and(or) other criteria) add the new users to a custom group then we wouldn't…

    3 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. Get user subscription keys programmatically

    It would be nice if as a developer I would be able to get my subscriptions keys (primary key and secondary key) programmatically. By programmatically I mean, for example, authenticate to a REST endpoint with my username and password developer portal, and then with another REST endpoint get only my keys. (similar to the management rest API but, without the ability to view or modify other users' information nor perform administrator tasks)

    3 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. Authorize latest DNS domains to create accounts on the developer portal

    Customer with "original" email addresses ( for example .garden, .paris, .fish... ) cannot create an account on the developer portal using the "Username and password" identity provider.

    They have an "Invalid email" error even though the email address exists.

    Would it be possible to authorize all the existing domains listed here for example : https://en.wikipedia.org/wiki/ListofInternettop-leveldomains

    Thanks

    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. Allow for R Code Samples

    It would be beneficial for researchers and developers to include a Code Sample for APIs in R.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    unplanned  ·  0 comments  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  11. 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 →
  12. 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…)
    1 comment  ·  Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
  13. 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.

    10 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 →
  14. 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 →
  15. 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 →
  16. 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
    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…

    21 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. Multi-brand support in Developer portal

    Multi-brand support in Developer portal

    7 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 →
  19. 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

    3 votes
    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 →
  20. 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.

    7 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…

  • Don't see your idea?

Feedback and Knowledge Base