Question

我为所有REST API使用标准的APIResponse对象接口。

public interface IAPIResponse
{
    IAPIError Error { get; set; }        
    IEnumerable<dynamic> Results { get; set; }
    void AddResult(string groupName, object data);

}

以下是我使用标准APIResponse对象的方法。

public async Task<IActionResult> Get()
{
        try
        {
           var response = new UsersGetResponse {
                   Users = await _someService.GetAll()};

            _apiResponse.AddResult("UsersGetResponse", response );

            return new ObjectResult(_apiResponse);
        }
        catch (Exception ex)
        {
            _apiResponse.Error = new APIError(ex.Message, 500);
            return new ObjectResult(_apiResponse);
        }            
}

对_someSerice.GetAll（）的调用返回以下用户对象的列表。

public interface IUser
{

    string Id { get; set; }
    bool IsAdmin { get; }
    string Name { get; set; }
    string Email { get; set; }
}

父类UsersGetResponse

的属性

public class UsersGetResponse
{
     public IList<User> Users { get; set;}
}

这将生成以下JSON。

{
"error": null,    
"results": [
{
  "UsersGetResponse": {

    "Users": [
      {
        "id": 171161,
        "isAdmin" : true,
        "name": "Dave Smith",
        "email": "Dave.Smith@gmail.com"
      },
      {
        "id": 171162,
        "isAdmin" : false,
        "name": "Jane Doe",
        "email": "Jane.Doe@gmail.com"            
      }
    ]
  }
}
]
}

如果我像这样使用ProducedResponseType注释。

[ProducesResponseType(typeof(IAPIResponse), StatusCodes.Status200OK)]

我只能在swagger中获得以下示例JSON。

{
  "error": {
    "message": "string",
    "number": 0
  },    
  "results": [
  {}
  ]
}

我正在尝试查看是否有方法与我的API的使用者正确沟通，我有一个标准的APIResponse对象，其动态结果具有像UsersGetResponse这样的特定对象。

Answer 1

这是因为您使用的是动态类型。 Swagger不承认任何＆＃34;属性＆＃34;在那种类型。如果您使用具体类型或界面，swagger将显示该对象的属性。

Answer 2

如果不完全了解您要尝试的范围，我将无法为您提供完整的解决方案。但是，根据您提供的信息，您应该这样做：

public sealed class APIResponse<T>
{
    IAPIError Error { get; set; }        
    T Results { get; set; }
}

public async Task<IActionResult> Get()
{
    var response = new ApiResponse<<IEnumerable<User>>>();
    try
    {
        var data = await _someService.GetAll();
        response.Result = data;

        return Ok(response);//returns 200 status code
    }
    catch (Exception ex)
    {
        response.Error = new APIError(ex.Message, 500);
        return BadRequrest(response);
    }            
}

然后您可以这样注释：

[ProducesResponseType(typeof(APIResponse<IEnumerable<User>>), StatusCodes.Status200OK)]

希望这有帮助。

描述REST API的动态响应类型

2 个答案: