诺云开放平台

Appearance

批量扣减积分 ​

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/Points/batchDecrPoints/2.0.0
  • 频率限制：10秒100次

请求参数 ​

参数必选类型描述
remarks否string备注
items是array扣减用户，一次最多100个

items 数组元素结构 ​

参数必选类型描述
wechat_user_space_id是integer用户ID
points是integer积分扣减数量（数量必须大于0）

请求示例 ​

json
{
  "remarks": "商品兑换扣减积分",
  "items": [
    {
      "wechat_user_space_id": 2001,
      "points": 100
    },
    {
      "wechat_user_space_id": 2002,
      "points": 50
    }
  ]
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
data是object响应数据
msg是string提示信息

data 参数结构 ​

参数必选类型描述
fail_count是integer失败数量
success_count是string成功数量
results是array操作结果

results 参数结构 ​

参数必选类型描述
wechat_user_space_id是integer用户ID
error_message是string错误信息（如果失败）
success是boolean操作是否成功
uid是integer商家ID
used_points是integer操作后的当前积分
points_change是integer实际积分变化量

响应示例 ​

json
{
  "code": 200,
  "data": {
    "fail_count": 0,
    "success_count": "2",
    "results": [
      {
        "wechat_user_space_id": 2001,
        "error_message": "",
        "success": true,
        "uid": 12345,
        "used_points": 50,
        "points_change": -100
      },
      {
        "wechat_user_space_id": 2002,
        "error_message": "",
        "success": true,
        "uid": 12345,
        "used_points": 100,
        "points_change": -50
      }
    ]
  },
  "msg": "Success"
}

错误响应示例 ​

json
{
  "code": 200,
  "data": {
    "fail_count": 1,
    "success_count": "1",
    "results": [
      {
        "wechat_user_space_id": 2001,
        "error_message": "",
        "success": true,
        "uid": 12345,
        "used_points": 50,
        "points_change": -100
      },
      {
        "wechat_user_space_id": 2002,
        "error_message": "积分不足",
        "success": false,
        "uid": 12345,
        "used_points": 30,
        "points_change": 0
      }
    ]
  },
  "msg": "Success"
}

注意事项 ​

  1. 批量限制：单次最多处理100个用户
  2. 积分数量：积分扣减数量必须大于0