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. Improve terminology (subscription, key)

    It's confusing that, for example, the rate-limit and quota policies have variations that are "by subscription" or "by key", when a "key" is also a crucial part of the subscription, but unrelated to the keys or values you can use to limit use.
    Subscription itself is also a confusing term vs the Azure subscription.
    I might suggest "registration" or "access key" for the APIM subscription, and the policies that limit by a "key" might just be called "by value" instead.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  API management experience  ·  Flag idea as inappropriate…  ·  Admin →
  2. API User Management - Enable change of API user names and email addresses

    Subscriptions for API products or single APIs are hard linked to the email address of the user. If the email address or name is changing (renaming of company a.s.o) we have to create new users with new subscriptions. For any kind of API integration it is not reasonable to our partners why they are getting new credentials and subscriptions.

    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 →
  3. Disable option for default developer portal...

    If developer portal can be self-hosted that it can be and this is a really good experience, so default developer portals should be set as disabled.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  API management experience  ·  Flag idea as inappropriate…  ·  Admin →
  4. Add support for configuring SSL settings of APIM instance using Git repo or Powershell

    We're trying to automate our deployment of APIM using the APIM git repositories. However, APIM currently doesn't support configuration for SSL settings of an APIM instance either using a git repository or Azure PowerShell cmdlets. We would like to have that support so that we can manage APIM completely through the git repository and powershell instead of having to change things in the Portal.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Service management  ·  Flag idea as inappropriate…  ·  Admin →
  5. Configure notifications programmatically

    We are populating and configuring our APIs using the REST API ( https://msdn.microsoft.com/en-us/library/azure/dn776326.aspx ), but there are a few settings that cannot be done programmatically and must be done by clicking into the portal.

    One of these settings is for the email notifications that are sent upon subscription requests, new subscriptions, etc. ( https://azure.microsoft.com/en-us/documentation/articles/api-management-howto-configure-notifications/#publisher-notifications ). We would like to be able to configure these programmatically, either via the REST API or some other way.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  API management experience  ·  Flag idea as inappropriate…  ·  Admin →
  6. Enhance Json Serialization support in Policy Expressions for Legacy Backend APIs

    Provide access to JsonConverter types, e.g. JavaScriptDateTimeConverter so that a JObject can be formatted as needed for a legacy system.

    Currently, if a Json object needs to be translated to a different format for a DateTime property it is not easily possible to convert the APIM body JObject to what the backend service expected for Json serialization.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Policies  ·  Flag idea as inappropriate…  ·  Admin →
  7. Azure Functions API import fails after setting IP restrictions on the Function

    The feature to import from Azure Functions to APIM does not work when Azure Functions has a firewall. Adding the APIM outgoing ip address to the list of allowed addresses still does not allow the import to work. Azure Functions and APIM should be able to seamlessly integrate together. Currently, we are not able to use IP restrictions.


    1. Create Azure Function

    2. Add IP Restriction and deny all traffic except for incoming traffic from APIM endpoint

    3. Try to import Azure Function endpoints to APIM

    4. The UI throws an error when actually trying to import

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Defining APIs  ·  Flag idea as inappropriate…  ·  Admin →
  8. Copy text-/image-sections

    Create a feature to be able to copy a text- or image-section via ctrl+c or a widget option and be able to paste in another section. It should work on the same page as well as on a different page.

    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 →
  9. When clicking "load more" in API operation list, it should load more (add to the list) and not replace the currently visible operations

    When clicking "load more" in API operation list in the Azure management portal, it should load more (add to the list) and not replace the currently visible operations. Lets say you have 25 operations for the selected API, and the first 20 are displayed by default and there is a "load more" button at the bottom of the operation list. and you click it. Currently, it removes the first 20 and only shows the last 5. If you want to see the first 20 again, you have to then click and select a different API and then go back to…

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  Defining APIs  ·  Flag idea as inappropriate…  ·  Admin →
  10. Optin/Optout on features & validations

    Often times I see that new validations are being rolled out by APIm team (recent one was from last week's May 11th release) where they rolled out a validation check to force uniqueness on API path (excluding parameters) which broke our builds when our release build is enroute to prod deploy. This also gives the power back to the consumers on when to opt in or opt out of any features you are releasing with future deployments .

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    unplanned  ·  0 comments  ·  API management experience  ·  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. Adding custom parameters for Notification Templates

    Provide an option to add custom parameters inside the notification templates.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Flag idea as inappropriate…  ·  Admin →
  13. Custom Headers Missing In Azure Portal Operation Test

    Recently, about a month ago, I was working on some policies for some of my API Operations and noticed when I went to test them in the Azure portal that my custom headers and defaults were missing. It seems there has been a change made that requires you to manually add the headers and select the default value in order to test the API >Operation. I have over 45 APIs with 100s of operations. I have headers defined with default values so that I can quickly open the API Operation and test the operation without having to set it up.…

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  API management experience  ·  Flag idea as inappropriate…  ·  Admin →
  14. [Developer portal] bring back Issues feature

    Would be nice to reintroduce the 'Issues' feature from the legacy portal into the new developer portal.

    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 →
  15. When subscription key headers change, the corresponding error messages should change

    In the subscription section of API settings, if 'Subscription Required' is checked off, APIM allows developers to change the default 'Header Name' from 'Subscription Key' to whatever they want. For one of my APIs, I changed it to 'Authorization', and changed the default 'Query parameter name' to 'authorization'

    When we send a request with an invalid subscription key (through the Authorization header), we get a 401 response with the following message body:

    {
    'statusCode': 401,
    'message': 'Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.'
    }

    Our customers do not know…

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Defining APIs  ·  Flag idea as inappropriate…  ·  Admin →
  16. POST "Comments- Add" Api issue on this api

    When we are using this Api, its returning status code as "Ok" and i am able to see the response with Comments Added, but i am not able to see those comments in workitem at AZDO. Can you suggest, why this happening? and what is the cause for it?

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Defining APIs  ·  Flag idea as inappropriate…  ·  Admin →
  17. Add indicator for which item is used

    When working with the new DevPortal checking which images are used in a certain widget comes in handy, when having many images uploaded

    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 →
  18. Url Helper Policy Expressions for Route Building

    As a developer I want to include hypermedia links to other operations in the same and other API sets so that I have easy navigation for clients between APIs.

    Today, these link url paths must be hard coded based on what is know. To provide flexibility while developing APIs and to ensure routes are actually valid, provide a url helper method to generate these routes.

    Example:

    context.RouteFor("API-ID", "Version", "Operation-ID", new {param1=1,param2="hello"})

    Today:

    <set-body>{
    return JObject.FromObject(new {

    _links = new[] {
    
    new { href = $&quot;/api/operation?query={context.Request.MatchedParameters.GetValueOrDefault(&quot;query&quot;, string.Empty)&amp;api-version=2018-10-31&quot;, rel = &quot;other-api&quot;, type = &quot;GET&quot; }
    }

    }
    }</set-body>

    With a helper:

    <set-body>{ …

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  Policies  ·  Flag idea as inappropriate…  ·  Admin →
  19. Support for token bucket - enable burst quota

    The current quota/call rate limit is +1 per call. In practice this means we create SKUs based on the maximum expected spike rather than average usage. By supporting a token bucket model (https://en.wikipedia.org/wiki/Token_bucket) we could define a SKU more aligned with our actual usage.

    For example: on average we have 50 calls per second, but need to be able to spike to 250 calls per second.

    Today we'd create a 250 calls per second throttle policy for this key/product which is not optimal.

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    under review  ·  0 comments  ·  Policies  ·  Flag idea as inappropriate…  ·  Admin →
  20. users documentation in multiple languages

    We need to maintain the developer portal on 2 languages (English and French). We want to have every single page in these languages: all content pages and all templated pages like products pages apis pages etc. .
    Can you direct me to the right documentation to implement this task for both the legacy Developer Portal and for the new Developer Poratl

    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 →
  • Don't see your idea?

Feedback and Knowledge Base