微伴助手OpenAPI

批量修改自定义字段的值

POST/open-api/external_user/remark/custom_field/batch_update

指定外部联系人id和员工id，在该外部联系人详情页中所属指定员工的自定义信息中指定的字段添加/修改值，最多允许批量修改10个自定义字段的值

错误码	说明
21801	最多允许批量修改10个自定义字段
21802	参数option_id，field_value，field_datetime不能同时为空
21803	存在无效的员工或外部联系人
21804	存在无效的field_id
21805	存在无效的option_id
21806	存在外部联系人和员工没有好友关系
21807	存在字段类型和传入的参数不正确
21808	时间格式不正确
21809	缺少参数
21810	自定义信息更新失败，请重试
21811	field_id为${field_id}的自定义字段不存在
调用此接口需购买基础席位。

请求参数

data_list

array [object {7}]

必需

external_user_id

string

外部联系人id

必需

staff_id

string

员工id

必需

field_id

integer

要修改的字段id

必需

option_id

integer

可选

当要修改的字段类型为选择时，传入该字段

field_value

string

可选

当要修改的字段类型为文本时，传入该字段,限制最多500个字符

field_datetime

string

可选

当要修改的字段类型为时间时，传入该字段格式（YYYY-MM-DD HH:mm:ss）

number_value

string

可选

最多两位小数，当要修改的字段类型为数值时，传入该字段

{
  "data_list": [
    {
      "external_user_id": "wm8xjUCAAAOgAFmo0QIZ6HrLb9kFP0zw",
      "staff_id": "ZhangSan",
      "field_id": 10000,
      "option_id": 654
    },
    {
      "external_user_id": "wm8xjUCAAAOgAFmo0QIZ6HrLb9kFP0zw",
      "staff_id": "LiSi",
      "field_id": 9999,
      "field_value": "样例文本"
    },
    {
      "external_user_id": "wm8xjUCAAAOgAFmo0QIZ6HrLb9kFP0zw",
      "staff_id": "WangWu",
      "field_id": 343,
      "field_datetime": "2021-9-12 14:23:37"
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

object {0}

{
  "errcode": 0,
  "errmsg": "ok"
}

最后修改时间： 9 个月前