Come reindirizzare dall'URL di root a/swagger/ui/index?

Question

Ho un progetto WebApi con Swashbuckle installato su di esso.

Nella configurazione predefinita, devo aprire nel browser http://localhost:56131/swagger/ui/index per visualizzare la descrizione delle operazioni e la pagina di test. Voglio che sia accessibile dalla radice del sito: http://localhost:56131/. Come posso raggiungere questo obiettivo?

Answer 1

influenzato da this answer to similar question, il codice leggermente modificato:

public class WebApiConfig 
{ 
    public static void Configure(IAppBuilder app) 
    { 
     var httpConfig = new HttpConfiguration(); 

     // Attribute routing 
     config.MapHttpAttributeRoutes(); 

     // Redirect root to Swagger UI 
     config.Routes.MapHttpRoute(
      name: "Swagger UI", 
      routeTemplate: "", 
      defaults: null, 
      constraints: null, 
      handler: new RedirectHandler(SwaggerDocsConfig.DefaultRootUrlResolver, "swagger/ui/index")); 

     // Configure OWIN with this WebApi HttpConfiguration 
     app.UseWebApi(httpConfig); 
    } 
} 

In questo modo non è necessario creare nuovo controller WebAPI come così ha fatto @bsoulier nella sua risposta.

Questa soluzione è basata sulla classe esistente RedirectHandler nell'assieme Swashbuckle.Core.

Answer 2

Se di sicuro utilizzare un progetto Web API, è possibile:

• abilitare Http Attribute Routing,
• creare il seguente metodo all'interno di un nuovo controller esistente o:

[Route(""), HttpGet] 
[ApiExplorerSettings(IgnoreApi = true)] 
public HttpResponseMessage RedirectToSwaggerUi() 
{ 
    var httpResponseMessage = new HttpResponseMessage(HttpStatusCode.Found); 
    httpResponseMessage.Headers.Location = new Uri("/swagger/ui/index", UriKind.Relative); 
    return httpResponseMessage; 
} 

Nota l'uso dell'attributo ApiExplorerSettings, in modo che non venga visualizzato nella definizione Swagger.