目录

常规验证-发送安全码


请求地址

管理后台创建软件后获取例: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值。

传参说明

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

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

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

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


函数参数

action=user&fun=sendSafeCode&username=用户名&flag=发送标记&safeType=发送类型&safeMode=邮箱或手机号&code=图文验证码

// @param username 用户名
// @param flag 发送标记,reg=注册验证码,rePwd=改密验证码
// @param safeType 发送类型,mail=邮件验证码,phone=手机验证码
// @param safeMode 绑定邮箱或手机,如果safeType=mail,则为邮箱,如果safeType=phone,则为手机号码

提交示例

{
    "action": "user",
    "clientid": "155dc0e2-e5df-47d6-a435-eccfd4fc7143",
    "code": "jnnv",
    "flag": "reg"
    "fun": "sendSafeCode",
    "key": "GorgBdTnRDYxQGxKC9pYB42O933Pzxx4",
    "m1": "f6725990b707458a9baf579b782ad1ad",
    "m2": "d41d8cd98f00b204e9800998ecf8427e",
    "m3": "a0368bba05140b66e8172247da2650ab",
    "safeMode": "user6@qq.com",
    "safeType": "mail"
    "mcode": "de11dbe0-aff6-d5ff-0e38-76e51d30ee21",
    "sid": "c1162b61-fa71-4214-b66b-014ae6b0a99a",
    "t": "1630821311",
    "username": "user6",
    "uuid": "d1c3bc86-cc4e-4d59-8010-eb9088e0a8d3",
    "webkey": "943e508419c4cd486ab894d3f7dbee50"
}

成功返回示例

{
    "status": "success",
    "code": "200",
    "uuid": "d1c3bc86-cc4e-4d59-8010-eb9088e0a8d3",
    "result": [],
    "msg": true,
    "token": "17c94bfcc0d705aabb6518ddadcf82a8",
    "t": 1630821313,
    "result_token": "94ab90abb9e671e373d3066b6ad5219f"
}

错误码

错误码 错误消息
243 用户名不合规,具体提示后台-系统设置-验证设置中设置
260 邮箱地址不符合规范.
208 验证码错误.
248 用户不存在或(邮箱/手机)错误.
274 短信发送失败,请联系客服处理.
275 发送频繁,请(N)秒后再试
249 邮件发送失败,请联系客服处理.
249 邮件发送失败,请联系客服处理.
276 通行证已被封停