C#使用RestClient向RESTful API提交嵌套JSON时嵌套字段为空如何解决

核心问题原因 #

1. 提交的JSON结构不匹配：API要求提交的JSON最外层必须包含contact字段来包裹所有联系人属性，你当前生成的JSON直接将first_name、email_addresses等属性放在根层级，服务端无法识别嵌套的邮箱、电话字段归属，导致字段为空。
2. 请求构造逻辑错误：你在请求路径中拼接了多余的?contact=参数，同时又将JSON放在请求体中，干扰了服务端的参数解析逻辑。

修正后的实现代码 #

// Endpoint: POST /v1/contacts.json
var client = new RestClient("https://api.tripleseat.com/v1/contacts.json")
{
    Authenticator = OAuth1Authenticator.ForProtectedResource(consumerKey, consumerSecret, null, null)
};

// 构造符合API要求的请求体，最外层加contact包裹
var requestBody = new
{
    contact = new
    {
        first_name = "Foo",
        last_name = "foo",
        account_id = 15998446,
        owned_by = 175177,
        email_addresses = new[]
        {
            new
            {
                address = "test@gmail.com"
            }
        },
        phone_numbers = new[]
        {
            new
            {
                number = "38239283928",
                // 可选字段按需添加
                // phone_number_type = "Main",
                // extension = "ex 5"
            }
        }
    }
};

var request = new RestRequest(Method.POST);
// 直接用AddJsonBody自动序列化，无需手动转JSON字符串，避免格式错误
request.AddJsonBody(requestBody);

RestResponse response = (RestResponse)client.Execute(request);

验证要点 #

修改后提交的JSON结构会和官方要求的示例完全对齐，服务端可正常解析email_addresses和phone_numbers的嵌套字段，返回结果中对应字段就会正常返回你提交的内容。

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