ASP.NET Core Web API如何根据第三方API的Http状态返回对应DTO

方案1：使用ActionResult<T>灵活返回不同响应 #

ASP.NET Core的ActionResult<T>支持返回不同类型的IActionResult实现，刚好适配你需要返回两种不同DTO的场景。

修改控制器方法签名 #

把原来仅返回SuccessRequestDto的方法，改成返回ActionResult<SuccessRequestDto>：

[HttpPost("register")]
public async Task<ActionResult<SuccessRequestDto>> RegisterStudent([FromBody] StudentRequestDto request)
{
    // 调用第三方API（建议通过依赖注入获取HttpClient，而非直接new）
    var thirdPartyResponse = await _httpClient.PostAsJsonAsync("第三方API接口地址", request);

    if (thirdPartyResponse.IsSuccessStatusCode)
    {
        var successDto = await thirdPartyResponse.Content.ReadFromJsonAsync<SuccessRequestDto>();
        return Ok(successDto); // 返回200状态码+SuccessRequestDto内容
    }
    else
    {
        var badRequestDto = await thirdPartyResponse.Content.ReadFromJsonAsync<BadRequestDto>();
        return BadRequest(badRequestDto); // 返回400状态码+BadRequestDto内容
    }
}

说明 #

• 当第三方API返回成功状态码（如200），用Ok()包装SuccessRequestDto返回；
• 当返回错误状态码（如400），用BadRequest()包装BadRequestDto返回；
• 客户端会收到对应HTTP状态码+匹配格式的响应体，完全贴合供应商的定义。

方案2：使用统一的GenericResponse作为返回类型 #

如果你希望接口返回统一的响应结构（无论成功失败），可以复用你已定义的GenericResponse类，调整结构兼容两种场景：

调整GenericResponse结构 #

用可空字段覆盖两种DTO的内容，增加标识字段区分状态：

public class GenericResponse
{
    public bool IsSuccess { get; set; }
    
    // BadRequest专属字段
    public string? ResponseCode { get; set; }
    public string? ResponseDescription { get; set; }
    
    // Success专属字段
    public string? Token { get; set; }
    public DateTime? ExpiryDate { get; set; }
}

修改控制器方法 #

返回GenericResponse，根据第三方响应填充对应字段：

[HttpPost("register")]
public async Task<GenericResponse> RegisterStudent([FromBody] StudentRequestDto request)
{
    var thirdPartyResponse = await _httpClient.PostAsJsonAsync("第三方API接口地址", request);
    var response = new GenericResponse();

    if (thirdPartyResponse.IsSuccessStatusCode)
    {
        var successDto = await thirdPartyResponse.Content.ReadFromJsonAsync<SuccessRequestDto>();
        response.IsSuccess = true;
        response.Token = successDto.Token;
        response.ExpiryDate = successDto.ExpiryDate;
    }
    else
    {
        var badRequestDto = await thirdPartyResponse.Content.ReadFromJsonAsync<BadRequestDto>();
        response.IsSuccess = false;
        response.ResponseCode = badRequestDto.ResponseCode;
        response.ResponseDescription = badRequestDto.ResponseDescription;
    }

    return response;
}

说明 #

这种方式返回的HTTP状态码始终为200，通过响应体的IsSuccess字段区分成功/失败，适合需要统一响应格式的业务场景。

额外注意事项 #

• 调用第三方API时，建议通过依赖注入获取HttpClient（在Program.cs中注册builder.Services.AddHttpClient()），避免频繁创建实例影响性能；
• 可根据第三方API的具体状态码做更细粒度处理，比如遇到401返回Unauthorized()，500返回StatusCode(500)等。

内容的提问来源于stack exchange，提问作者Ayobamilaye