常规验证-扣点

请求地址

管理后台创建软件后获取例：http://demo.huweidun.cn/ac.php?s=8508c320cacb0634c0e241df2f3345fe

公共提交参数

公共返回参数

传参说明

• 只需按规则拼接参数后加密传送即可。

• 封包内参数分为公共参数和函数参数。

• 公共参数为所有命令均需要提交的参数。

• 函数参数根据不同函数说明决定提交哪个参数，对应函数内均有说明。

函数参数

action=deductpoint&user=扣点账号&num=扣除点数&msg=扣点备注&interval=0

提交示例

{
    "action": "deductpoint",
    "clientid": "fd3c15de-ef05-461b-72bf-edb342ab118c",
    "interval": "0",
    "key": "GorgBdTnRDYxQGxKC9pYB42O933Pzxx4",
    "m1": "00f8812c19778ad923d043ba03069016",
    "m2": "d41d8cd98f00b204e9800998ecf8427e",
    "m3": "a0368bba05140b66e8172247da2650ab",
    "mcode": "de11dbe0-aff6-d5ff-0e38-76e51d30ee21",
    "msg": "测试扣点5点.",
    "num": "5",
    "sid": "c1162b61-fa71-4214-b66b-014ae6b0a99a",
    "t": "1630822224",
    "user": "user6",
    "uuid": "318cadca-e153-4104-7e15-9a5c137fc933",
    "webkey": "943e508419c4cd486ab894d3f7dbee50"
}

成功返回

{
    "status": "success",
    "code": "200",
    "uuid": "318cadca-e153-4104-7e15-9a5c137fc933",
    "result": {
        "point": "495"
    },
    "msg": "",
    "token": "62662eb5a798ca738b274191f13c3e5b",
    "t": 1630822223,
    "result_token": "0b66a18dc90a9f23429aded114fef037"
}

数据主体解析（result）

point 点数余额。

失败返回

一般失败原因为账户点数余额不足，具体请参照返回状态码。

{
    "status": "error",
    "code": "225",
    "uuid": "c73684e4-fa74-4b87-8391-fa0c00e564d8",
    "result": null,
    "msg": "\u70b9\u6570\u4e0d\u8db3,\u6263\u70b9\u5931\u8d251.",
    "token": "08b5663c923cfd71efc2c2a845f94d2d",
    "t": 1630822360,
    "result_token": null
}

特别说明

• 如果未开启记录扣点日志则remarks和interval参数无效。每次调用该函数，均扣点。

• 如果已开启记录扣点日志，则只有相同的数量和备注，才会校验interval。

• 扣点示例（已开启记录扣点日志）下方演示了多项目穿插扣点。

应用场景

• 记录扣点日志
  用户群体有查看扣点明细的需求下，开启记录扣点日志后，用户可以在用户中心查看历史扣点记录，消费更加清晰。

• 互斥体
  扣点函数中的扣除点数与扣点备注为检测重复扣点的互斥体，如果两项均相同，则校验是否在扣点间隔内，在间隔内，说明没到扣点时间，不扣点，如已超过间隔，则扣点。常应用于不需要重复扣点的场景，例如24小时内使用某功能，不重复扣点，那么间隔就是86400秒。

应用举例

例子前提：微博养号软件，三个功能，1.注册账号（扣5点），2.登录账号（每号24小时内扣2点），发文（扣2点）。

1. 每注册一个账号hwd_deductPoint(5,"注册扣点",0);这里无需校验扣点间隔，执行一次扣5点。
2. 每登录一个账号hwd_deductPoint(2,"登录扣点[操作的账号]",86400);首次执行扣2点，24小时内同账号重复登陆，不重复扣点。
3. 每发布一条博文hwd_deductPoint(2,"发文扣点",0);这里无需校验扣点间隔，执行一次扣2点。
4. ps.第2步使用的互斥体为登录扣点[操作的账号]这里有个可变因素操作的账号，使用此方法可以保证每个操作的账号为独立的互斥体。

错误码