如何在Web API中接收Curl请求？求正确实现方案

问题背景 #

尝试在Web API方法中接收Curl请求，但无法成功解析请求数据。
请求数据结构示例：

Array
(
    [post_data] => Array
        (
            [DL] => 2
            [ID] => 8NNGQ8Q5
            [ShipCity] => CLEARWATER
            [ShipState] => FL
            [ShipZip] => 33762
            [ShipCountry] => US
        )
)

自行编写的Web API方法：

public HttpResponseMessage GetQuote(HttpRequestMessage request, [FromBody] Request model)
{
    try
    {
        var abf = Request.Content.ReadAsStringAsync();
        return request.CreateResponse(HttpStatusCode.OK, abf);
    }
    catch (Exception)
    {
        return request.CreateResponse(HttpStatusCode.BadRequest);
    }
}

可行实现建议 #

1. 匹配请求结构定义模型类 #

请求数据外层有post_data层级包裹，你的Request模型类必须对应这个结构，同时注意键名的大小写匹配（如果请求用下划线命名，需用特性映射）：

public class Request
{
    [JsonProperty("post_data")]
    public PostData PostData { get; set; }
}

public class PostData
{
    public int DL { get; set; }
    public string ID { get; set; }
    public string ShipCity { get; set; }
    public string ShipState { get; set; }
    public string ShipZip { get; set; }
    public string ShipCountry { get; set; }
}

2. 修复异步操作的错误使用 #

ReadAsStringAsync()是异步方法，直接返回的是Task<string>对象而非实际请求内容，必须添加await关键字，同时方法要标记为async：

public async Task<HttpResponseMessage> GetQuote(HttpRequestMessage request, [FromBody] Request model)
{
    try
    {
        var abf = await Request.Content.ReadAsStringAsync();
        return request.CreateResponse(HttpStatusCode.OK, abf);
    }
    catch (Exception)
    {
        return request.CreateResponse(HttpStatusCode.BadRequest);
    }
}

3. 确认请求的Content-Type并适配 #

• 如果Curl请求发送的是JSON格式数据，确保请求头包含Content-Type: application/json，此时[FromBody]可以正常绑定模型。
• 如果发送的是表单数据（application/x-www-form-urlencoded），需调整读取方式：

public async Task<HttpResponseMessage> GetQuote(HttpRequestMessage request)
{
    var formData = await request.Content.ReadAsFormDataAsync();
    // 解析post_data字段内容，可手动反序列化为对象
    return request.CreateResponse(HttpStatusCode.OK);
}

4. 增加模型绑定校验 #

在方法中检查ModelState的有效性，快速排查绑定失败的原因：

if (!ModelState.IsValid)
{
    return request.CreateResponse(HttpStatusCode.BadRequest, ModelState);
}

内容的提问来源于stack exchange，提问作者A.Goutam