SurveyMonkey API能否通过单次GET请求获取全状态联系人？

好问题！我之前处理过类似的需求，特意核对了SurveyMonkey的API规范，给你梳理下目前的情况：

• 首先明确：当前SurveyMonkey的/contacts端点并不支持通过单次GET请求同时获取active、optout、bounced三种状态的联系人。官方设计里，status查询参数仅接受单个值（可选值包括active、optout、bounced、pending），没法用逗号分隔或者类似all的通配符来批量指定多个状态。

那有没有更高效的替代方案？当然有——你不需要串行发起三次请求，而是可以并行发起三个请求，这样能大幅减少总耗时，然后把三个接口返回的结果合并起来就行。

举个JavaScript的示例，用Promise.all实现并行请求：

const getAllContacts = async () => {
  const apiToken = '你的API令牌';
  const baseUrl = 'https://api.surveymonkey.com/v3/contacts';
  const authHeaders = { Authorization: `Bearer ${apiToken}` };

  // 并行请求三种状态的联系人接口
  const [activeResp, optoutResp, bouncedResp] = await Promise.all([
    fetch(`${baseUrl}?status=active`, { headers: authHeaders }),
    fetch(`${baseUrl}?status=optout`, { headers: authHeaders }),
    fetch(`${baseUrl}?status=bounced`, { headers: authHeaders })
  ]);

  // 解析每个请求的响应数据
  const activeData = await activeResp.json();
  const optoutData = await optoutResp.json();
  const bouncedData = await bouncedResp.json();

  // 合并所有联系人数据（注意处理分页，如果数据量超过单页限制）
  const allContacts = [
    ...activeData.data,
    ...optoutData.data,
    ...bouncedData.data
  ];

  return allContacts;
};

// 调用函数获取所有联系人
getAllContacts().then(allContacts => {
  console.log('整理好的所有联系人:', allContacts);
});

另外要注意分页问题：如果你的联系人数量超过了API默认的单页返回上限（通常是50条），每个状态的请求都需要处理分页逻辑——检查响应里的next_url字段，循环请求直到获取完所有数据，再合并最终结果。

总的来说，虽然没法用单次GET请求直接拿到三种状态的联系人，但并行请求的方案已经是目前最高效的处理方式了。

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