目录

常规验证-取功能卡参数


请求地址

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

公共提交参数

参数名 示例值 参数说明
sid
00362ace-e994-411a-a9bf-f31f9177b6f3
软件SID,后台添加软件后获得。
uuid d6fadd40-7267-4178-9b35-4c8ff61e0c07 封包安全码,每次必须变动,用于校验数据合法性方案之一。
t 1630766594 客户端10位时间戳。
m1 590b782aa78cc3333c84eaa975ab9dc1 封包token(sid+key+t 拼接后取MD5值)
m2 b1dfd79c7cf0f5df8f77c12352af952c 当前程序MD5值,如果开启校验MD5,则此值必填,可于程序运行时动态读取自身MD5值。
m3 f50ebce838ae4b8e212578dd0bc23d9f moduleMd5,购买授权后获得,如使用dll文件,请传入DLLMD5值,同时在”后台-系统-系统设置”中填写。
mcode b4f43bb8-32dc-4d9a-9094-74e39cd61c37 客户端机器码(自行获取机器码,若机器码变动则会提示转绑[如果开启”绑定机器码”])
clientid 36ebe72d-51d8-4252-b99c-37da152717ac 客户端运行ID,此ID在软件退出之前不可变动,也就是每次启动都生成一个新的clientid,软件退出即作废。
webkey 0241946994e62e289e4622b07154b961 通用秘钥(webKey),购买授权后获得。

公共返回参数

参数名 示例值 参数说明
status
success
success为正常,error为错误。
code 200 200为正常,其它为错误。
msg 账号或密码错误. 错误内容,无错误返回空。
token 324daaf6558361aa8f27d607c72262af 返回封包token(提交封包中的m1+返回封包中t,拼接后取MD5值)
t 1630766888 封包时间戳
uuid d6fadd40-7267-4178-9b35-4c8ff61e0c07 提交封包的UUID,原样返回。
result 请查看不同函数说明 数据主体,Json格式,每个函数返回的数据不同,具体请参照对应函数说明。
result_token 627b0d546ccb1d4896373305d74c6933 数据主体token,将数据以ASCII首字母递增排序,拼接键名与键值,拼接完毕后加上通信秘钥一起取MD5值。

传参说明

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

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

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

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


1.获取功能卡到期时间

action=getFunctionEndtime&fun=endtime&flag=0&username=用户名&name=功能卡标记

action 固定值:getFunctionParam
fun 固定值:endtime
username 用户名
flag 0:超级会员,1:软件用户
name 功能卡标记

提交示例

{
    "action": "getFunctionParam",
    "clientid": "c7a805be-ab4b-00ea-b8ff-f86d95a20dd7",
    "flag": "0",
    "fun": "endtime",
    "m1": "de595aca84282a88b408f626015e9aaf",
    "m2": "b2e3e708476d575fd1199bb056dffc59",
    "m3": "f4f419903b3cb14cb2177ec54122f299",
    "mcode": "d41d8cd9-8f00-b204-e980-0998ecf8427e",
    "name": "test",
    "sid": "9c20ea42-12eb-42b2-a543-a02f742280ff",
    "t": "1750703045",
    "username": "test002",
    "uuid": "76d0e3f4-0e55-9e34-9ebc-aafe8ea2522c",
    "webkey": "e5ba7716777cdf02520f66da7e9bd718"
}

获取成功返回(当name为空时,返回所有功能卡的到期时间)

{
    "status": "success",
    "code": "200",
    "uuid": "8f270a61-bd52-3dd5-ca08-323b8b68c441",
    "result": {
        "functionInfo": "{\"test\":{\"endtime\":\"2025-06-23 17:11:10\",\"cid\":\"11\"}}",
        "serverTime": "2025-06-23 17:52:06",
        "serverTimestamp": "1750672326"
    },
    "msg": "success",
    "token": "0b28e1a9d3a7ea275da05489c0a10be5",
    "t": 1750672326,
    "result_token": "afb01049283be47428dc089b0cf887a2",
    "action": "getFunctionEndtime"
}

获取成功返回(当name为非空时,返回当前功能标记的到期时间)

{
    "status": "success",
    "code": "200",
    "uuid": "b3c964f6-2016-c08f-7428-c6943ed3d5be",
    "result": {
        "functionInfo": "{\"endtime\":\"2025-06-23 17:11:10\",\"cid\":\"11\"}",
        "serverTime": "2025-06-23 17:52:03",
        "serverTimestamp": "1750672323"
    },
    "msg": "success",
    "token": "96f3835247ae2dd7ba4f3f7d865af639",
    "t": 1750672323,
    "result_token": "011ef7304efc913a0fff2d18046044a4",
    "action": "getFunctionEndtime"
}

数据主体解析(result)

result.functionInfo 到期时间,注意,name是否为空,返回的节点不同。
result.serverTime 服务器时间,例如:2025-06-23 17:56:22。
result.serverTimestamp 服务器时间十位Unix时间戳,例如:1750672323。

错误码

状态码 状态消息
200
201 用户名不能为空
203 通行证不存在
204 软件用户不存在
205 flag参数错误
206 尚未购买功能卡
300 未知错误,一般不会出现.

2. 获取功能卡自定义常量

action=getFunctionParam&fun=para&flag=0&username=用户名&name=功能卡标记

action 固定值:getFunctionParam
fun 固定值:para
flag 0:超级会员,1:软件用户
username 用户名
name 功能卡标记

提交示例

{
    "action": "getFunctionParam",
    "clientid": "c7a805be-ab4b-00ea-b8ff-f86d95a20dd7",
    "flag": "0",
    "fun": "para",
    "m1": "80379335882982a4a42f7778a77c09b2",
    "m2": "b2e3e708476d575fd1199bb056dffc59",
    "m3": "f4f419903b3cb14cb2177ec54122f299",
    "mcode": "d41d8cd9-8f00-b204-e980-0998ecf8427e",
    "name": "test",
    "sid": "9c20ea42-12eb-42b2-a543-a02f742280ff",
    "t": "1750703047",
    "username": "test002",
    "uuid": "3ed5a53e-511e-f0ec-d676-317100f9ea5e",
    "webkey": "e5ba7716777cdf02520f66da7e9bd718"
}

返回示例

{
    "status": "success",
    "code": "200",
    "uuid": "3ed5a53e-511e-f0ec-d676-317100f9ea5e",
    "result": {
        "body": "{\"test\":\"\u6f14\u793a\u5e38\u91cf\"}"
    },
    "msg": "success",
    "token": "e673722d674d04731d880b2aef45d897",
    "t": 1750703057,
    "result_token": "c3ba05cbd63d4fbb39aadf5b65b9cfe7",
    "action": "getFunctionParam"
}

数据主体解析

result.body 当前卡类的自定义常量

错误码

状态码 状态消息
200
201 用户名不能为空
203 通行证不存在
204 软件用户不存在.
205 flag参数错误
207 尚未购买功能卡
208 功能卡标记不能为空
300 未知错误,一般不会出现.

3. 取功能卡独立自定义常量

action=getFunctionParam&fun=paraA&flag=0&username=用户名&name=功能卡标记&key=xxx

action 固定值:getFunctionParam
fun 固定值:paraA
flag 0:超级会员,1:软件用户
username 用户名
name 功能卡标记
key 独立自定义常量名称

提交示例

{
    "action": "getFunctionParam",
    "clientid": "c7a805be-ab4b-00ea-b8ff-f86d95a20dd7",
    "flag": "0",
    "fun": "paraA",
    "key": "test1",
    "m1": "675153caae8b444e6d53bbf89af8bc77",
    "m2": "b2e3e708476d575fd1199bb056dffc59",
    "m3": "f4f419903b3cb14cb2177ec54122f299",
    "mcode": "d41d8cd9-8f00-b204-e980-0998ecf8427e",
    "name": "test",
    "sid": "9c20ea42-12eb-42b2-a543-a02f742280ff",
    "t": "1750703049",
    "username": "test002",
    "uuid": "42f480fd-f99b-f0d2-1b72-c19256f7ab0c",
    "webkey": "e5ba7716777cdf02520f66da7e9bd718"
}

返回示例

{
    "status": "success",
    "code": "200",
    "uuid": "42f480fd-f99b-f0d2-1b72-c19256f7ab0c",
    "result": {
        "body": "\u6f14\u793a\u72ec\u7acb\u81ea\u5b9a\u4e49\u5e38\u91cf"
    },
    "msg": "success",
    "token": "2495dd0c42a72e382a29e509ef1cfcec",
    "t": 1750703059,
    "result_token": "04f1c5b815db114c933a5eef4de4efce",
    "action": "getFunctionParam"
}

数据主体解析

result.body key所对应的独立自定义常量的值.

错误码

状态码 状态消息
200
201 用户名不能为空
203 通行证不存在
204 软件用户不存在
205 flag参数错误.
206 功能卡标记名不存在
207 尚未购买功能卡
208 功能卡标记不能为空
209 独立自定义常量key不存在
300 未知错误,一般不会出现.