# 群积分修改

说明: 至少填入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": "备注"
         }'
最后更新时间: 2024/11/25 15:39:16