MGALV2-单码心跳

接口描述

xin_tiao 简单来说就是让你后台知道这个卡密是不是在线状态，需要使用单码登录成功后获取登录成功后得到的token才能进行调用。

方法签名

🐾 参数说明

参数名	类型	必填	描述
`appid`	`String`	`是`	简单来说就是应用中心对应应用的应用编号。
`token`	`String`	`是`	简单来说就是单码登录成功得到的token参数！
`xyjm`	`String`	`是`	响应内容的加密方式，可以传 `"jm"`（加密）或 `"mw"`（明文），注意！后台需要设置相应的加密规则。
`qqjm`	`String`	`是`	请求加密方式，决定是否对请求参数进行加密。可以传 `"jm"`（加密）或 `"mw"`（明文）。
`sjskq`	`boolean`	`否`	是否启用安全码校验，`true` 表示启用，会将安全码添加到请求中，防止恶意篡改；`false` 表示关闭。
`sjs`	`String`	`否`	随机数（安全码），当 `sjskq` 为 `true` 时，该参数是必需的，否则可以传入 `null`。
`qianmingkq`	`boolean`	`否`	是否启用签名校验，`true` 启用签名校验，`false` 关闭签名校验，注意，签名方式目前支持一！
`yymiyao`	`String`	`是`	应用密钥，用于生成数字签名，用于生成数字签名！
`qmfs`	`String`	`否`	签名方式，用于生成数字签名的加密算法，支持 `"MD5"`、 `"SHA1"`、 `"SHA256"` 等，如果未开启签名校验，传入 `null`。
`jmfs`	`String`	`是`	加密方式，支持 `"AES"`、 `"AES1"`、 `"AES2"`、 `"DES"`、 `"RC4"` ，根据后台的设置来进行设置就好啦！
`bmfs`	`String`	`是`	编码方式，用于指定加密数据的编码方式，支持 `"16进制"` 或 `"BASE64"` 编码，填写1表示使用16进制，填写2表示使用BASE64。
`jmpy`	`String`	`否`	加密偏移量， `AES1` 和 `AES2`需要此参数，没有用这些算法时传入 `null` 即可。
`jmmy`	`String`	`是`	加密密钥，用于加密请求参数。如果加密方式开启，该参数为必填。
`qqjg`	`String`	`是`	请求间隔时间，单位可以是秒（s）、分钟（min）、小时（h）等，注意，这个在后台设置的时候，建议设置的短一些，不然可能会出现卡密登录过后会显示已经在线无法登录的情况！
`huidiao`	`jieguo_huidiao`	`是`	回调接口，用于处理请求的异步响应，返回的结果为 `JSON` 格式。

返回值说明

返回类型: void

回调接口: jieguo_huidiao

回调接口 `jieguo_huidiao` 说明

参数名	类型	描述
`jieguo`	`String`	返回的 `JSON` 数据或错误码。

🐾 错误码

"200": 请求成功，返回 JSON 数据。

"101": 网络请求失败，可能由于网络连接问题或服务器未响应。

"102": 响应不成功，服务器返回了错误响应。

"103": 解密失败，可能是由于密钥、偏移量或加密参数不正确导致。

"105": appid 参数为空，未传入应用标识符。

"106": token 参数为空，未传入用户标识。

"108": xyjm 参数不合法，未识别的响应加密方式。

"109": qqjm 参数不合法，请求加密方式不正确。

"110": 签名生成失败，可能由于签名参数错误或算法不支持。

"111": 无效的加密算法，传入的 jmfs 加密方式不被支持。

"112": 数据加密失败，密钥或编码方式错误。

"114": 签名方式不支持，传入的 qmfs 签名算法不被支持。

"201": 请求间隔时间太短，需至少为 6 秒。

调用示例

🐾 小提示

接口返回示例:

{
    "msg": "心跳成功",
    "code": 1,
    "signature": "e8e4c6162b59795efe704a59cac26f4b",
    "timestamp": "1714580692697"
}

注意：

当未启用签名校验或随机数安全码功能时，签名方式、随机数等相关参数将不会生效，需要根据你后台的实际需要进行操作！

回调返回的 JSON 数据直接解析就能使用。

注意，接口在出现网络异常波动，或者后台直接对卡密进行下线操作，会对token进行重连，重连三次失败后，将会直接闪退应用。

接口描述#

方法签名#

🐾 参数说明#

返回值说明#

回调接口 jieguo_huidiao 说明#

🐾 错误码#

调用示例#

🐾 小提示#