描述REST API的动态响应类型

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)]

我只能大张旗鼓地获得以下示例JSON。

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

我正在尝试查看是否有一种方法可以正确地与我的API使用者进行通信，我有一个标准的APIResponse对象，并且具有带有特定结果（例如UsersGetResponse）的动态结果。

Answer 1

这是因为您正在使用动态类型。 Swagger无法识别该类型的任何“属性”。 如果您改用具体类型或接口，则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)]

希望这可以帮助。