MVC C# Web应用调用Ellucian Ethos API返回400 Bad Request但Postman正常
接口调用异常根因分析
- 400 Bad Request 错误:
PutAsJsonAsync方法内置对象序列化逻辑,传入提前序列化完成的JSON字符串时,方法会将字符串作为普通值二次序列化,最终提交的报文会被增加多余转义符、外层双引号,不符合API入参格式要求。 - 406 Not Acceptable 错误:Ellucian Ethos API对请求的
Accept、Content-Type头有强制规范,需要指定对应资源版本的自定义媒体类型,默认HttpClient调用未配置对应请求头,且System.Text.Json默认序列化规则(如字段命名、空值处理、日期格式)可能与API要求不匹配。
修复方案
核心调整点
- 给HttpClient配置Ethos API要求的授权头、Accept头,媒体类型版本需与你在Postman中使用的资源版本一致
- 自定义JSON序列化配置匹配API规则,避免字段不识别问题
- 选择正确的请求发送方式,避免二次序列化
可运行修复代码片段
using System.Net.Http.Headers; using System.Text.Json; // 初始化HttpClient并配置全局请求头 using var httpClient = new HttpClient(); // 配置授权令牌 httpClient.DefaultRequestHeaders.Add("Authorization", $"Bearer {accessToken}"); // 配置Ethos API要求的Accept头,版本号根据你调用的资源版本调整 httpClient.DefaultRequestHeaders.Accept.Add( new MediaTypeWithQualityHeaderValue("application/vnd.hedtech.integration.v12+json")); // 配置匹配API要求的JSON序列化规则 var jsonSerializeOptions = new JsonSerializerOptions { PropertyNamingPolicy = JsonNamingPolicy.CamelCase, IgnoreNullValues = true, WriteIndented = false }; // 方式1:自行构造请求内容发送,完全可控序列化逻辑 var requestJson = JsonSerializer.Serialize(h11Data, jsonSerializeOptions); var requestContent = new StringContent(requestJson, System.Text.Encoding.UTF8, "application/vnd.hedtech.integration.v12+json"); var response = await httpClient.PutAsync($"https://{ethosDomain}/api/persons/{personGuid}/h11", requestContent); // 方式2:使用PutAsJsonAsync直接传对象+自定义序列化配置,无需提前序列化 // var response = await httpClient.PutAsJsonAsync( // $"https://{ethosDomain}/api/persons/{personGuid}/h11", // h11Data, // jsonSerializeOptions);
校验补充项
- 确认
H11Model的字段名称、数据类型、必填项与API文档完全一致,无多余的未定义字段 - 确认请求头中的媒体类型版本号与Postman中成功请求的版本号完全相同
内容的提问来源于stack exchange,提问作者Jamie
相关产品推荐
相关产品推荐

