批量增减客户积分

POST

/open-api/integral/batch/update

批量增减客户积分

错误码	说明
22001	批量增加或削减积分参数校验失败
调用此接口需购买营销席位。

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

unionid

array[string]

必需

客户unionid, 仅当联系人类型是微信用户，且企业绑定了微信开发者ID有此字段;参数上限为100个，超出则返回错误

unionid_openid_list

array [object {2}]

可选

密文企业，客户unionid/openid, 仅当联系人类型是微信用户，且企业绑定了微信开发者ID有此字段;参数上限为10个，超出则返回错误

unionid

string

客户unionid

可选

openid

string

客户openid

可选

integral

integer

增减积分

必需

示例

{
    "unionid": [
        "string"
    ],
    "unionid_openid_list": [
        {
            "unionid": "string",
            "openid": "string"
        }
    ],
    "integral": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/integral/batch/update?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unionid": [
        "string"
    ],
    "unionid_openid_list": [
        {
            "unionid": "string",
            "openid": "string"
        }
    ],
    "integral": 0
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

状态码，0为正常，非0代表错误。业务错误码下述，全局错误码见全局错误码

errmsg

string

必需

错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

fail_unionid

array[string]

可选

执行失败客户的unionid

no_exist_unionid

array[string]

可选

不存在客户的unionid

示例

{
    "errcode": 0,
    "errmsg": "string",
    "fail_unionid": [
        "string"
    ],
    "no_exist_unionid": [
        "string"
    ]
}

🟢200正常返回

修改于 2024-06-28 07:41:21

获取批量加好友待添加列表

批量获取客户积分