You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

通过Zapier代码调用API发送POST请求时遇返回格式错误求助

Zapier Code POST请求报错:"You must return a single object or array of objects" 解决方案

我来帮你搞定这个问题——这个报错其实是Zapier Code步骤的核心要求没满足,和你的POST请求逻辑本身关系不大,主要是代码最后没有返回符合格式要求的内容。

错误原因

Zapier的Code模块(不管是Node.js还是Python)有个硬性规则:你的代码必须返回一个单个JavaScript对象或者对象数组,哪怕你只是发送个请求不需要用返回值,也得给Zapier一个符合要求的返回内容。很多人容易只顾着写请求逻辑,忘了这最后一步,就会触发这个报错。

修复示例(结合你的代码)

假设你原来的代码大概是这样的(只处理了请求,没返回值):

const API_URL = "https://myapi.com"; 
const DATA = { siteId: "xxxx", id: input.id }; // 这里假设inp是Zapier的input变量

// 发送请求但没返回任何符合要求的内容
fetch(API_URL, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(DATA),
});

只需要给请求加上返回逻辑,确保最后输出一个对象/数组就行,比如这样修改:

const API_URL = "https://myapi.com"; 
const DATA = { siteId: "xxxx", id: input.id };

// 处理异步请求并返回符合要求的对象
return fetch(API_URL, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(DATA),
})
.then(response => response.json()) // 解析API返回的JSON数据
.then(apiResponse => {
  // 返回API的响应,包装成对象(Zapier就能识别了)
  return { api_response: apiResponse };
})
.catch(error => {
  // 捕获错误也要返回对象,方便后续步骤排查问题
  return { request_error: error.message };
});

几个容易踩的坑

  • 忘记加return关键字:如果你的请求是异步的(比如用fetch),一定要把整个Promise链return出去,不然Zapier拿不到返回值。
  • 返回非对象/数组内容:别直接return字符串(比如return "请求成功"),必须包装成对象,比如return { status: "请求成功" }。
  • 异步逻辑没处理:如果用了async/await,记得要写async function,最后return对象:
    const API_URL = "https://myapi.com"; 
    const DATA = { siteId: "xxxx", id: input.id };
    
    async function sendRequest() {
      try {
        const response = await fetch(API_URL, {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify(DATA),
        });
        const data = await response.json();
        return { success: true, data: data };
      } catch (error) {
        return { success: false, error: error.message };
      }
    }
    
    return sendRequest();
    

只要保证代码最后返回的是单个对象或者对象数组,这个报错就会消失啦。

内容的提问来源于stack exchange,提问作者Jeff Hall

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.26 10:27:18