用户积分调整

  • 接口：common/point/adjust
  • Method：POST
  • 数据格式：JSON
  • 接口说明：调整用户积分, 在原来的积分上增加或减少
  • 其他补充信息：
    • user_name 或 employee_number 至少填写一种, 如果两种都填写则取 user_name
    • adjust_point 如果为正数, 则在原来的积分上增加, 若为负数则减少, 不可为 0
    • 积分不可以被扣减为负数

bizId

  • 格式：标准 UUID 字符串（RFC 4122），36 个字符，形如 0255bda8-ae0f-44c2-84e4-f16821854fc9。 不传时服务端可自动生成。

body

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
bizId String 当前次接口同步的唯一标识 FALSE 36
timestamp Long 当前次接口同步的时间戳 FALSE 13
data. Object 请求数据体 TRUE 无
data.user_name String 用户名 ONE-OF 无
data.employee_number String 员工号 ONE-OF 无
data.adjust_point Decimal 积分调整数 TRUE 无
data.description String 描述 FALSE 255

示例:

请求数据

{
  "bizId": "0255bda8-ae0f-44c2-84e4-f16821854fc9",
  "timestamp": 1702521344000,
  "data": {
    "employee_number": "CAN000193",
    "description": "测试",
    "adjust_point": 5.00
  }
}

返回报文

成功时 resMsg 为 用户积分调整成功。

{
    "resCode": 200000,
    "resMsg": "用户积分调整成功",
    "bizId": "0255bda8-ae0f-44c2-84e4-f16821854fc9"
}

常见业务错误

resMsg 说明
无效的积分 adjust_point 为空或与 0 相等
userName与employeeNum必填其一 未传 user_name 且未传 employee_number
该用户不存在 hulk 未查到用户
积分余额不足无法扣减 扣减后可用余额（余额−冻结+调整额）小于 0

results matching ""

    No results matching ""