扣点 - webAPI
公共提交参数,每个命令都需要提交以下公共参数
请求地址:管理后台-软件列表中获取对应软件API地址
请求类型:post
提交参数:data=URL编码后密文&sign=sign
参数名 参数说明
sid 软件SID,后台添加软件后获得
uuid 通用唯一识别码,每次必须变动,用于校验数据合法性方案之一.
t 客户端10位时间戳
m1 临时封包token(sid+key+t 拼接后取MD5值)
m2 当前程序MD5值,如果开启校验MD5,则此值必填,可于程序运行时动态读取自身MD5值.
m3 moduleMd5,购买授权后获得,如使用dll文件,请传入DLLMD5值,同时在"后台-系统-系统设置"中填写.
mcode 客户端机器码(自行获取机器码,若机器码变动则会提示转绑[如果开启"绑定机器码"])
clientid 客户端运行ID,此ID在软件退出之前不可变动,也就是每次启动都生成一个新的clientid,软件退出即作废.
webkey 通用秘钥(webKey),购买授权后获得.

公共返回参数,每个命令都按如下格式返回
参数名 参数说明
status success为正常 error为错误
code 200为正常,其它为错误,请参照错误码表
msg 错误内容明文,请参照错误码表
token 返回封包token(提交封包中的m1+返回封包中t,拼接后取MD5值)
t 封包时间
uuid 提交封包的UUID
result 数据主体,每个函数返回的数据不同,具体请参照对应函数说明.
result_token 数据主体token,将数据以ASCII首字母递增排序,拼接键名与键值,拼接完毕后加上通信秘钥一起取MD5值.

函数参数:action=deductpoint&user=扣点账号&num=扣除点数&msg=扣点备注&filter=0

filter : 是否过滤,0.不过滤,1.过滤.开启后可防止重复扣点(当扣点点数与扣点备注重复时),需在软件后台开启:记录扣点日志.

这个功能很有用,假设一款发帖软件,按发帖成功扣点则无需过滤,每次扣点就可以.

假设按天数扣点呢?一天内无论使用多少次,只扣一次点数,只需开启过滤,然后将备注加上日期:"扣点日期:2020年2月16日"

如果重复使用此备注,并开启过滤,只有第一次会扣点,之后都会被过滤掉.当第二天,日期变了,又会扣点成功一次.


完整提交明文:

{
    "action": "deductpoint",
    "user": "quecongsoft",
    "num": "5",
    "msg": "测试扣点日志",
    "filter": "0",
    "sid": "d6fadd40-7267-4178-9b35-4c8ff61e0c07",
    "key": "9d8af871e74f5629639544a314adab96",
    "uuid": "50ce8986-c85c-45db-94e4-81991f22a683",
    "t": "1581854143",
    "m1": "9fcbc213cc1715c9753fa386ccf3c7af",
    "m2": "d41d8cd98f00b204e9800998ecf8427e",
    "m3": "a0368bba05140b66e8172247da2650ab",
    "mcode": "F1E5FD6B-FC18-49EE-A3E5-5C51C5DE1224",
    "webkey": "2a829dd8bce3c480b714c737259760f9",
    "clientid": "c3431448-da50-4fd4-7f01-e705622c19a7"
}


完整返回明文:

{
    "status": "success",
    "code": "200",
    "uuid": "50ce8986-c85c-45db-94e4-81991f22a683",
    "result": {
        "point": "45"
    },
    "msg": "",
    "token": "64750a58e021b920b01e8e7b89d25ca2",
    "t": 1581854136,
    "result_token": "37e4cdbea0bd8ec4dcce547a9336e483"
}


数据主体解析:

result.point : 扣点完毕后的账户余额,如果开启过滤且备注重复,则不会扣点,直接返回余额.

Copyright © 2019-2059 HuWeiDun.Cn All rights reserved.
登记号:2019SR0828127 软著登字第4248884号 冀ICP备19021017号