{"id":84787,"date":"2023-03-23T05:00:45","date_gmt":"2023-03-23T04:00:45","guid":{"rendered":"https:\/\/code-maze.com\/?p=84787"},"modified":"2024-01-31T15:35:43","modified_gmt":"2024-01-31T14:35:43","slug":"apsnetcore-webapi-addendpointsapiexplorer-method","status":"publish","type":"post","link":"https:\/\/code-maze.com\/apsnetcore-webapi-addendpointsapiexplorer-method\/","title":{"rendered":"The AddEndpointsApiExplorer Method in ASP.NET Core"},"content":{"rendered":"

In this article, we are going to learn about the AddEndpointsApiExplorer method in ASP.NET Core. We will learn why we need it and how we use it in our applications.<\/p>\n

For this article, we will use an ASP.NET Core Web API application with Swagger support. If you feel the need to brush up, we have an introductory article about setting up Swagger<\/a>.<\/p>\n

To download the source code for this article, you can visit our GitHub repository<\/a>.<\/div>\n

Let’s begin.<\/p>\n

What is AddEndpointsApiExplorer Method?<\/h2>\n

The AddEndpointsApiExplorer()<\/code> is an extension method in the Microsoft.AspNetCore.Mvc.ApiExplorer<\/code> package that comes bootstrapped with the Web API.<\/p>\n

When setting up a Web API in Visual Studio, the AddEndpointsApiExplorer()<\/code> method comes as part of the boilerplate code in the Program.cs<\/code> file.<\/p>\n

The method call builder.Services.AddEndpointsApiExplorer()<\/code>\u00a0registers services that expose information about our endpoints:<\/p>\n

public static IServiceCollection AddEndpointsApiExplorer(this IServiceCollection services)\r\n{\r\n    \/\/ Try to add default services in case MVC services aren't added.\r\n    services.TryAddSingleton<IActionDescriptorCollectionProvider, DefaultActionDescriptorCollectionProvider>();\r\n    services.TryAddSingleton<IApiDescriptionGroupCollectionProvider, ApiDescriptionGroupCollectionProvider>();\r\n\r\n    services.TryAddEnumerable(\r\n        ServiceDescriptor.Transient<IApiDescriptionProvider, EndpointMetadataApiDescriptionProvider>());\r\n\r\n    return services;\r\n}<\/pre>\n
These services are used by Swagger and any other API documentation tool to generate documentation for our API in order for it to know underlying information<\/span>.<\/p>\n
The vital information we get in the documentation includes endpoint URLs, HTTP methods, request parameters, and schemas for our requests and responses.<\/p>\n
Having set a foundation on what the method is and what it does, let’s pass to action.<\/p>\n
Why Do We Need AddEndpointsApiExplorer Method?<\/h2>\n
Let’s set up a new ASP.NET Core Web API project in Visual Studio with Open API support enabled. Alternatively, we could use the command line by running the command:<\/p>\n
dotnet new webapi -n SampleApi<\/code><\/p>\n
After that, let’s add a Minimal API<\/a> endpoint to the Program.cs<\/code> file:<\/p>\n
app.MapGet(\"\/car-models\", () => new[] { \"Chevrolet\", \"Tesla\", \"Nissan\" });<\/code><\/p>\n
For learning purposes and to understand the effect of the AddEndpointsApiExplorer()<\/code> method, let’s go ahead and delete it from Program.cs<\/code>. When we run our application, we only see the \/WeatherForecast<\/code> endpoint in the Swagger UI documentation.<\/p>\n
Internally, Swagger uses types registered by the<\/strong> AddEndpointsApiExplorer()<\/code> method to generate API documentation<\/strong>. It goes without saying, that when we remove the method call, these necessary services aren’t registered. That’s why the MapGet endpoint is missing in Swagger UI.<\/p>\n
On the other hand, the controller endpoint is displayed because the AddControllers()<\/code> method calls AddApiExplorer()<\/code>\u00a0which only registers services to discover controller endpoints and not Minimal API endpoints<\/strong>. If you want to learn more about AddApiExplorer()<\/code> check out this Introduction to ApiExplorer<\/a> by Andrew Lock.<\/span><\/p>\n
Now, let’s add back the AddEndpointsApiExplorer()<\/code> method call to the Program.cs<\/code> file. At this point, if we run the API we get a Swagger UI with the two endpoints:<\/p>\n