meta {
  name: 快速添加联系人
  type: http
  seq: 2
  tags: [
    generated
  ]
}

post {
  url: {{baseUrl}}/api/customer/contact/quickAdd
  body: formUrlEncoded
  auth: inherit
}

body:form-urlencoded {
  customerId: 753314901191032832
  rows[0].name: cg034667张总
  rows[0].jobTitleCode: chairman
  rows[0].phone: 13800001001
  rows[0].source: group_meeting
  rows[0].isKeyContact: 1
  rows[1].name: cg034667李经理
  rows[1].jobTitleCode: marketing_manager
  rows[1].phone: 13800001002
  rows[1].source: group_activity
  rows[1].isKeyContact: 0
}

docs {
  # 快速添加联系人（多行）
  `POST /api/customer/contact/quickAdd`（本行兼作对账钥匙，勿手改）
  部分成功：合法行落库、非法行明细返回（空行跳过；有手机号按手机号查重、无手机号按客户+姓名+职务疑似重复提示不静默创建）；职务走 job_title 字典 code 联动补全 id/名称/类别/档位（D1 初始值，level_source=1）；任一行成功即 bump 图谱版本。失败行留在编辑器改完只重提失败行，不重复创建；行号 rowIndex 按提交数组下标从 0 计。

  ## 请求参数

  | 参数 | 类型 | 必填 | 默认 | 说明 |
  | --- | --- | --- | --- | --- |
  | customerId | string | 是 | - | 目标客户 id（固定，不可切换） |
  | rows[i].name | string | 是 | - | 联系人姓名 |
  | rows[i].jobTitleCode | string | 是 | - | 标准职务字典 code（job_title 组二级项；联动补全 id/名称/类别/档位） |
  | rows[i].phone | string | 否 | - | 手机号（可空；非空须 11 位格式） |
  | rows[i].source | string | 否 | - | 来源字典 code（contact_source 组，可空） |
  | rows[i].isKeyContact | number | 否 | 0 | 是否关键联系人（是1/否0，空=0） |

  ## 请求示例

  请求头：Authorization: Bearer {{token}}
  Content-Type: application/x-www-form-urlencoded

  POST /api/customer/contact/quickAdd
  customerId=753314901191032832&rows[0].name=cg034667张总&rows[0].jobTitleCode=chairman&rows[0].phone=13800001001&rows[0].source=group_meeting&rows[0].isKeyContact=1&rows[1].name=cg034667李经理&rows[1].jobTitleCode=marketing_manager&rows[1].phone=13800001002&rows[1].source=group_activity&rows[1].isKeyContact=0&rows[2].name=cg034667王专员&rows[2].jobTitleCode=marketing_specialist&rows[2].phone=13800001003&rows[2].source=referral&rows[2].isKeyContact=0&rows[3].name=cg034667赵四&rows[3].jobTitleCode=other_job&rows[3].phone=13800001004&rows[3].source=other&rows[3].isKeyContact=0

  ## 响应 data 结构

  | 字段 | 类型 | 说明 |
  | --- | --- | --- |
  | successCount | number | 成功行数（部分成功：合法行落库） |
  | failedRows | array | 失败行明细（空=全部成功） |
  | failedRows[].rowIndex | number | 行号（提交数组下标，从 0 计） |
  | failedRows[].reason | string | 失败原因（行级校验/查重提示） |

  ## 错误码

  - 67021 快速添加整批不可用（行集空；行级错误走结果明细 200）

  ## 响应示例

  // 示例数据（E2E 实测真值），字段结构以上表为准
  ```json
  {
    "code": 0,
    "success": true,
    "message": "success",
    "data": {
      "successCount": 4,
      "failedRows": []
    }
  }
  ```
}