Google Apps Script调用Streak API时PUT请求失败求助

这种情况我之前也碰到过——CURL正常但GAS的PUT请求失败，基本都是请求配置的细节没跟上Streak API的要求，毕竟UrlFetchApp的默认行为和CURL有不少差异。下面是几个最可能的原因和对应的解决方法：

1. 未正确设置Content-Type请求头 #

Streak API的PUT接口通常要求请求体为JSON格式，CURL里你肯定加了-H "Content-Type: application/json"，但GAS的UrlFetchApp默认不会自动设置这个头，导致请求被API拒绝。

错误示例（缺少Content-Type）：

const apiKey = "YOUR_STREAK_API_KEY";
const url = "https://www.streak.com/api/v1/pipelines/{PIPELINE_ID}";
const payload = {
  name: "Updated Pipeline Name"
};

const response = UrlFetchApp.fetch(url, {
  method: "PUT",
  headers: {
    "Authorization": `Bearer ${apiKey}`
    // 这里缺少Content-Type
  },
  payload: payload
});

修正后：

const apiKey = "YOUR_STREAK_API_KEY";
const url = "https://www.streak.com/api/v1/pipelines/{PIPELINE_ID}";
const payload = {
  name: "Updated Pipeline Name"
};

const response = UrlFetchApp.fetch(url, {
  method: "PUT",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json" // 必须添加这个头
  },
  payload: JSON.stringify(payload), // 还要把对象转成JSON字符串
  muteHttpExceptions: true // 开启这个才能看到详细错误信息
});

// 打印错误详情方便调试
console.log(response.getResponseCode());
console.log(response.getContentText());

2. Payload未转为JSON字符串 #

CURL里用-d '{"key":"value"}'是直接传JSON字符串，但GAS如果直接传JavaScript对象，UrlFetchApp会默认把它编码为application/x-www-form-urlencoded格式，这和Streak API期望的JSON格式不匹配，导致PUT请求失败。

一定要用JSON.stringify()把payload对象转换成字符串，这是最容易踩的坑！

3. 未启用muteHttpExceptions调试 #

默认情况下，UrlFetchApp遇到HTTP错误（比如400、403）会直接抛出异常，不会返回详细的错误信息。开启muteHttpExceptions: true后，你可以获取到Streak API返回的具体错误提示（比如“invalid field X”或者“missing required parameter”），这能帮你快速定位问题。

4. 检查请求体的字段匹配 #

有时候CURL里的字段名和GAS里的拼写不一致（比如大小写、下划线/驼峰差异），Streak API对字段名是敏感的。比如CURL里用pipelineName，GAS里写成pipelinename就会报错，一定要严格对照Streak API文档的字段名。

对比你的CURL请求 #

把你的CURL请求和GAS配置做逐一对比：

示例CURL请求：

curl -X PUT "https://www.streak.com/api/v1/pipelines/{PIPELINE_ID}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Updated Pipeline Name"}'

确保GAS里的：

• 请求方法（PUT）一致
• 所有请求头（Authorization、Content-Type）都包含
• Payload的结构和CURL里的JSON完全一致（包括字段名、嵌套结构）

按照上面的方法调整后，你的PUT请求应该就能正常工作了。如果还是有问题，把response.getContentText()返回的错误信息贴出来，我们可以进一步排查！

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