批量修改自定义字段的值

POST

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

openapi

指定外部联系人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}的自定义字段不存在
调用此接口需购买基础席位。

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

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"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/external_user/remark/custom_field/batch_update?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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成功

application/json

Body

object {0}

示例

成功示例成功示例

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

🟢200正常返回

修改于 2024-03-05 06:41:33

批量预设客户属性

创建批量加好友任务（批量创建添加客户任务）