# 群积分修改
说明: 至少填入1个客户id(union_id或external_userid)
请求方式:POST
请求地址:https://$basehost/gateway/qopen/UpdatePointsAccount
body参数:至少填入1个客户id(union_id或external_userid)
{
"union_id": "微信平台的union_id",
"plan_id": "积分方案id",
"points": 1,
"type": 0,
"remark": "备注",
"external_userid": "微信平台的客户的external_userid",
"transaction_id": "123445",
"points_update_behavior": 0
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
union_id | string | 否 | 微信平台的union_id |
plan_id | string | 是 | 积分方案id |
points | int | 是 | 积分数值 |
type | int | 否 | 类型,0 减少积分 1增加积分(不传默认为0) |
remark | string | 是 | 备注, 不能为空, 最多允许100个字符 |
external_userid | string | 否 | 微信平台的客户的external_userid |
transaction_id | string | 否 | 流水号,用于幂等操作,确保同一笔交易不会被重复处理,有效时间为48小时 |
points_update_behavior | int | 否 | 积分修改行为: 0: 积分不足仍扣除积分,调用接口后返回成功,积分为0;1:积分不足时返回失败,不扣除积分(不传默认为0) |
返回值:
{
"data": {
"transaction_id": "123445"
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
hint | string | 请求日志ID |
transaction_id | string | 流水号,用于幂等操作,确保同一笔交易不会被重复处理,有效时间为48小时 |
完整请求示例:
curl -X POST https://$basehost/gateway/qopen/UpdatePointsAccount \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"union_id": "微信平台的union_id",
"plan_id": "积分方案id",
"points": 1,
"remark": "备注"
}'