DotNet Mirror
  DNM facebook   DNM Google+   DNM Twitter   

how to host Restful API using Azure App Service

By Ashok Nalam on 04 Jul 2024 | Category: Microsoft Azure | Tagged: azure app service API ASP.NET Core 
In this article, we will learn how to create ASP.NET Core Web API with a sample endpoint and host a sample restful API endpoint using Azure App Service.
  Discuss Add Comment   |  
Add rating Rate this resource   


Azure App Service is a fully managed Platform as a Service (PaaS) that enables the building and deploying web applications, Restful APIs, mobile backends without managing the underlying infrastructure.

RESTful is an architecture style where service receives and sends data from and to client applications. The goal of the application is to centralize the data that different client applications can use. ASP.NET Core Web API gives us a powerful, easy-to-use API to achieve these goals. 

In this article, we will learn how to create ASP.NET Core Web API with a sample endpoint and host the sample restful API endpoint to Azure using Azure App Service. 

Create Sample API Application

Open Visual studio > Create new project > Select “ASP.NE Core Web API” template > Click on Next


Fig 1 : Create ASP.NET WebAPI Project

Enter project name as “First API App” (Give the name of your preference) > Next


Fig 2 : WebAPI Project – Enter project details

Leave next page as defaults and click on Create


Fig 3 : WebAPI Project – Additional details

It creates a solution with WeatherForecast as default controller which contains a get method or else you can add your own controller with get, post and other http methods. In this case, let's stick to the default Weather Forecast data. 


Fig 4 : Default API created as part of Project

Run the solution and it opens swagger in localhost and you can see Swagger Open API definition and methods. Click on WeatherForecast and Execute button to get the list of weather data.

 Fig 5 : Default API - Swagger local view of Weather data

As the API is working locally, now let’s deploy the API to Azure Web App. From the solution explorer, click on Project > Publish option > Select Target as “Azure


Fig 6 : Publish - Target to Azure

Select Azure App Service (Windows) > Log in with your Azure Account > Click on new > it creates a new App with hosting plan. Choose the right plan, in this case, I selected Free service plan(F1) > click on Create > After a few seconds, it creates the App in Azure. 


Fig 7 : Publish to Azure – Create Service with Plan

Fig 8 : Publish to Azure – Service is created

Skip API management step and click on OK. 


Fig 9 : Publish to Azure – Publish the Application

Now the App is ready with all the settings > click on Publish > It takes some time to deploy the API application and once the deployment is done, App opens in the browser > Sometime you may see page not found error.


Fig 10 : Run App from Azure – default view showing error

But when you browse the API( directly it is showing the data but swagger is not loading, which means there is a problem with swagger loading in Azure and let’s fix it. 


Fig 11- Run App from Azure – Direct API view

This error is because by default swagger is configured to open in the development environment (with in IDE), to work in Azure, comment below if condition code from AppSettings.cs file from the project code.

if (app.Environment.IsDevelopment())





Redeploy the App to Azure, by clicking publish button again, Now browse the app using URL and it opens swagger definition. Select WeatherForecast Get endpoint and click on execute endpoint should result the data.


Fig 12 : Run App from Azure – Swagger view loaded


In this article, we understood

  1. how to create default ASP.NET Core WebAPI 
  2. Run the local view of endpoint using Swagger
  3. Created Azure App Service from Visual Studio with Publish view
  4. Deployed API App to App Service
  5. Fixed Swagger issue on Azure App Service
  6. Able to view the API endpoint view from Azure App Service


  Discuss Add Comment    
Add rating Rate this resource   
About the Contributor
Member Since : 10 Dec 2012
Member Points (Level) : 9526  (Professional)
Location : INDIA
Home Page :
About : I am admin of this site.
Rate this resource
Add your Comment
Name Email WebSite
Captcha Refresh

Comments (0)
No comments found, click here to add comment.
cheap jordans|wholesale air max|wholesale jordans|wholesale jewelry|wholesale jerseys