时间戳

首页 > 解决方案 > 为 swagger 的“试用”指定示例请求

c# - 为 swagger 的“试用”指定示例请求

问题描述

有没有办法指定招摇的示例请求？甚至可能是多个？

该Try it out按钮仅显示通用值，例如：

{
    "firstName": "string",
    "lastName": "string"
}

为了

public class User
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
}

当您必须首先编辑所有值时，使用大型对象变得非常困难。我知道我可以使用 Postman，我也这样做，但是能够使用 swagger 创建多个好看且有用的示例将非常好。

标签： c#asp.net-core-webapiswagger-uiswashbuckle.aspnetcore

解决方案

使用 ASP.NET Core 3.1、Swagger OAS 3 和 Swashbuckle.AspNetCore 5.4.1，以下模型类 + XML 注释适用于我：-

    /// <summary>
    /// A user.
    /// </summary>
    public class User
    {
        /// <summary>
        /// The user's first name.
        /// </summary>
        /// <example>Jane</example>
        public string FirstName { get; set; }

        /// <summary>
        /// The user's last name.
        /// </summary>
        /// <example>Austin</example>
        public string LastName { get; set; }
    }

现在，当我单击“试用”（对于User在消息正文中采用模型的 POST 操作）时，我得到默认值：-

{
    "firstName": "Jane",
    "lastName": "Austin"
}

推荐阅读