NetSuite Restlet GET请求返回400错误的原因排查

问题现象 #

• 用于获取供应商账单的NetSuite Restlet GET接口，在Postman中直接调用正常，但C#代码里必须添加空JSON请求体+Content-Type头才能收到正常响应
• 不添加上述代码时，接口返回400 Bad Request错误
• 另一使用HttpClient的应用无法设置请求体，需要解决该兼容性问题

可能原因 #

虽然HTTP规范里GET请求通常不需要携带请求体，但NetSuite的Restlet实现或你的脚本可能存在特殊逻辑：

• Restlet脚本的输入校验：你部署的Restlet脚本（script=571）可能被编写成强制检查Content-Type头是否为application/json，或者期望接收一个（哪怕是空的）请求体，否则直接返回400错误
• NetSuite服务器的隐性要求：部分NetSuite Restlet部署对GET请求的格式有非标准限制，当缺少Content-Type: application/json时，服务器判定请求格式非法
• Postman与C#请求的头差异：Postman发送GET请求时可能自动添加了某些默认头（比如Content-Type），而C#的HttpRequestMessage默认不会添加，导致请求不符合NetSuite的校验规则

解决办法 #

方案1：修改Restlet脚本（推荐） #

如果有权限修改NetSuite端的Restlet脚本，调整输入校验逻辑，遵循HTTP规范处理GET请求：

• 允许GET请求不携带请求体和Content-Type头
• 直接从URL参数（entity、tranId等）获取所需数据

示例SuiteScript调整方向：

/**
 * @NApiVersion 2.x
 * @NScriptType Restlet
 */
define(['N/record'], function(record) {
    function get(context) {
        // 直接从context读取URL参数，无需依赖请求体
        var entityId = context.entity;
        var tranId = context.tranId;
        // 后续业务逻辑...
    }
    return {
        get: get
    };
});

方案2：在HttpClient中模拟兼容请求（无法修改脚本时） #

如果无法修改Restlet脚本，且应用使用HttpClient，可以通过HttpRequestMessage创建请求来设置空请求体：

private async Task<string> CallNetSuiteRestlet()
{
    string url = "https://tstdrv11111111.restlets.api.netsuite.com/app/site/hosting/restlet.nl?script=571&deploy=1&entity=1552&tranId=test1";
    var request = new HttpRequestMessage(HttpMethod.Get, url);
    
    // 添加认证和接受头
    request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", myToken);
    request.Headers.Add("Accept", "application/json");
    
    // 添加空请求体和Content-Type头以兼容NetSuite
    request.Content = new StringContent("");
    request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
    
    using (var client = new HttpClient())
    {
        var response = await client.SendAsync(request);
        response.EnsureSuccessStatusCode();
        return await response.Content.ReadAsStringAsync();
    }
}

方案3：对比Postman请求头补全差异 #

检查Postman发送的完整请求头，找出C#请求缺失的关键头并手动添加：

1. 在Postman中开启请求日志，查看所有自动添加的请求头
2. 在C#的request.Headers中添加这些头（注意：部分头属于请求体专属头，直接加在Headers可能无效，优先尝试方案1或2）

总结 #

问题本质是NetSuite Restlet的实现（或你的脚本）对GET请求做了非标准格式要求，最彻底的解决方式是修改Restlet脚本遵循HTTP规范；如果无法修改脚本，则通过添加空请求体和对应头来兼容服务器校验。

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