Jul 26, 2026

Comissioning Azure API Management Service

Azure API management is a comprehensive solution to add intermediate layer to handle all you APIs from one single point. Below is a well described illustration on main components. 


First of all we will see how to create a API management service and how it will be presented to end users via its Portal. In this example we will not add a new API but use in built sample for explanation porpose. 

1. Create Azure API management service

I am creating a new API Management Service by providing Subscription, Resource Group etc
    

Once hit the Create button it could take bit of time to complete the creation process. Once created we can see the Portal URL within many details presended in Overview.


Also notice that, upon create, we have already a sample API created which we can use to play around.


2. Portal Point : Administration

By clicking Developer Portal link we will get the Portal opned in a different tab in Administrative Mode. 


This allows us to change design and contents as we wish. Then Save and Publish.


Alternatively you can publish the Portal by clicking Publish under Portal overview. (It is also advisable to Enable CORS)


3. Portal Point : Enble for end user

To view the end user experiance, you need to open the Portal in InProvate browser.
If you dont publish the Portal as per one of the ways explaind in previous step, Portal will not be visible. Below error will be shown.


Assuming you are a new user, now can be sign up (use a different email than your admin one already in the system as the Administrator)



This will also send you a email to verify before proceeding.

Alternatively, you can add users from Users under Developer Portal.


Now you are able to login as a end user.

4. Portal Point : End user access to Portal
Once logged in as the end user, browse to Products menu item to enable subscriptions.


Give a name and request subscription for each.
After that, under profile I can see Starter is Active but Unlimited is still in Sumbitted status.


Now from Azure side, go to API Management Service, APIs, Subscription then select the subscripion which is not active yet and make it Active.


If you go back to Portal you will now see as both Subscriptions Active. Lets go to API and click the our of Box API we have just got the subscriptions activated.


Click it and click Try this Operation for any method. I selected Retrieve resource. Resulted popup will allow you to select the subscription too. Click Send.


Now we are getting the expected 200 OK response back, meaning we are executint it correctly and getting a respose back.


End user is now good to use the API.