探马OpenAPI

更新企微客户详情（批量）

已废弃

POST

/api/v2/customer/qw-updates

注意

已废弃接口, 不再随系统的迭代更新而升级。

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

updates

array [object {3}]

批量更新客户数据

可选

如果传空或 null，接口什么也不操作，返回成功

externalUserId

string

客户企微id

必需

如果同一批修改中的客户id出现重复，则重复修改中哪一个修改会最终生效是不确定的，调用方应避免在同一批更新调用中使用重复的客户id。

qwUserId

string

执行修改的销售企微id。

必需

updates

array [object {2}]

对当前客户的更新字段列表

必需

示例

{
  "updates": [
    {
      "externalUserId": "wmPBvlDQAAAtqjxUNvuEL5CRio1NWNXA",
      "qwUserId": "LiuFuLai",
      "updates": [
        {
          "id": 680,
          "value": [
            "15811111122"
          ]
        },
        {
          "id": 681,
          "value": [
            "虎鲸接口qw"
          ]
        },
        {
          "id": 683,
          "value": [
            "刘工🐶"
          ]
        },
        {
          "id": 698,
          "value": [
            "开发呀"
          ]
        }
      ]
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v2/customer/qw-updates' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "updates": [
        {
            "externalUserId": "wmPBvlDQAAAtqjxUNvuEL5CRio1NWNXA",
            "qwUserId": "LiuFuLai",
            "updates": [
                {
                    "id": 680,
                    "value": [
                        "15811111122"
                    ]
                },
                {
                    "id": 681,
                    "value": [
                        "虎鲸接口qw"
                    ]
                },
                {
                    "id": 683,
                    "value": [
                        "刘工🐶"
                    ]
                },
                {
                    "id": 698,
                    "value": [
                        "开发呀"
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

业务状态码

必需

成功状态为0。参见响应业务状态码表。注意此状态标示成功不代表批量更新中每一条都成功，请关注 data 中各更新行结果状态

message

string

业务状态说明。

必需

data

array [object {4}]

结果列表

必需

code

integer

结果状态码

可选

成功状态0。参见响应业务状态码表

message

string

结果状态说明

可选

qwUserId

string

销售企微id

可选

externalUserId

string

客户企微id

可选

示例

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "code": 0,
      "message": "success",
      "qwUserId": "LiuFuLai",
      "externalUserId": "wmPBvlDQAAAtqjxUNvuEL5CRio1NWNXA"
    }
  ]
}

🟢200异常

修改于 2023-05-31 06:17:20

变更跟进人

修改客户积分