调用Airtable API POST接口提交数据时产生重复记录问题

重复记录和你提交的单份payload内容无关，是代码执行逻辑的问题：

• 向Airtable提交数据的postAt函数被写在了遍历学生数组的for循环内部，每处理完1个学生，就会把当前newUsers.records里累积的所有待新增记录全量提交一次，而非等所有新用户筛选完成后仅提交一次。
  举个实际执行的例子：如果共有3个符合新增条件的学生，第一次循环提交1条记录，第二次循环提交累积的2条记录，第三次循环提交累积的3条记录，最终Airtable会生成6条记录，绝大多数为重复条目。
• 未在筛选逻辑开始前初始化newUsers对象，如果同一次脚本运行中多次执行这段筛选逻辑，会残留上一次筛选出的用户数据，进一步造成重复提交。
• 现有存在性判断用Array.find实现，该方法会返回匹配到的完整对象，仅做存在性校验时用Array.some性能更好、逻辑更直观。

待新增用户筛选逻辑 #

// 每次执行筛选前初始化空的payload容器，避免残留旧数据
const newUsers = {
  records: []
};

for (let user1 of modStuArray) {
  if (user1.status === 'enrolled' || user1.status === 'admitted') {
    // 直接返回是否存在匹配用户的布尔值
    const userExists = atToCompare.some(user2 => user2.oa_id === user1.oa_id);
    if (!userExists) {
      newUsers.records.push({
        fields: {
          ...user1
        },
      });
    }
  }
}

// 所有用户遍历、筛选完成后，再统一发起提交
// 注意：Airtable单批次创建记录接口最多支持10条数据，若待新增用户超过10个，需要拆分为多个批次依次提交
if (newUsers.records.length > 0) {
  postAt('app38098wehf','Students',newUsers)
}

Airtable提交函数 #

原有提交函数逻辑无问题，可保持不变：

function postAt (baseId, tableName, payload){
  var options = 
      {
        method: 'POST',
        headers: {
          'Authorization' : 'Bearer ' + atToken,
          'Content-Type'  : 'application/json',
          "Accept": "application/json"
        },
        payload : JSON.stringify(payload),
      };
  var response = UrlFetchApp.fetch('https://api.airtable.com/v0/' + baseId + "/" + encodeURIComponent(tableName),    
  options).getContentText();
  return(response);
}

• 可在Airtable Students表中给oa_id字段开启唯一值约束，从数据存储层拦截重复提交，即使脚本逻辑出问题也不会生成重复的oa_id记录。
• 若单次待新增用户量经常超过10，可加一段切片分批逻辑，每10条记录调用一次postAt，避免触发Airtable接口参数错误或限流。

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