You need to enable JavaScript to run this app. MVC C# Web应用调用Ellucian Ethos API返回400 Bad Request但Postman正常
优惠活动
大模型
产品
解决方案
定价
更多

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要求不匹配。
修复方案

核心调整点

  1. 给HttpClient配置Ethos API要求的授权头、Accept头,媒体类型版本需与你在Postman中使用的资源版本一致
  2. 自定义JSON序列化配置匹配API规则,避免字段不识别问题
  3. 选择正确的请求发送方式,避免二次序列化

可运行修复代码片段

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 19:00:01