Cách chuyển hướng từ url gốc sang/swagger/ui/index?

Question

Tôi có một dự án WebApi với Swashbuckle được cài đặt trên đó.

Trong thiết lập mặc định, tôi phải mở trong trình duyệt http://localhost:56131/swagger/ui/index để xem trang mô tả hoạt động và trang thử nghiệm của tôi. Tôi muốn nó có thể truy cập từ gốc của trang web: http://localhost:56131/. Làm thế nào tôi có thể đạt được điều này?

Answer 1

Bị ảnh hưởng bởi this answer to similar question, mã chút thay đổi:

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); 
    } 
} 

Bằng cách này nó không phải là cần thiết để tạo ra bộ điều khiển WebAPI mới như cũng vậy @bsoulier trong câu trả lời của mình.

Giải pháp này dựa trên lớp hiện có RedirectHandler trong số Swashbuckle.Core lắp ráp.

Answer 2

Nếu bạn chắc chắn sử dụng một dự án Web API, bạn có thể:

• phép Http Attribute Routing,
• tạo phương pháp sau đây trong vòng một hiện tại hoặc điều khiển mới:

[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; 
} 

Note việc sử dụng thuộc tính ApiExplorerSettings, để nó không hiển thị trong định nghĩa Swagger.