账户认证 - 计次

[TOC]

简要描述

• 卡号按使用次数认证，认证成功一次，可使用次数减少一次

请求URL

• 线路 1 https://api.018888.xyz/v2.2/eapi/
• 线路 2 https://cdn.018888.xyz/v2.2/eapi/
• 线路 3 https://api.kushao.net/v2.2/eapi/

请求方式

• POST / GET

请求参数

参数名	必选	类型	说明
id	是	string	项目 I D
data	是	string	加密参数

• data :【cardcs 卡号 设备ID 当前时间戳 sign】使用 | 按顺序拼接后AES加密
• sign :【卡号 设备ID 当前时间戳 项目密钥】按顺序拼接后取Md5
• 注意 : cardauth 常量，其余参数变量，时间戳 10 位；拼接不得含有空格

请求示例

// AES加解密KEY：后台配置的项目密钥
// AES加解密参数：AES/128/ECB/PKCS5Padding
// 直接复制该段代码并不能运行，因为缺少必要的方法和变量
// 该段代码的主要目的在于演示 data sign 两个参数的正确拼接
let api = "https://api.018888.xyz/v2.1/eapi/";
let id = 项目ID;
let skey = 项目密钥；
let card = 卡号;
let devId = 设备ID;
let t = 当前时间戳;
let sign = md5(card + devId + t + skey);
let data = "cardcs|" + card + "|" + devId + "|" + t + "|" + sign;
data = encrypt(data);  //AES 加密 data
let res = http.post(api, {
    id: id,
    data: data,
});

返回示例

{
    code: "W9bfke6qd1ya85RkTJLoWg==", 
    num: "I2LXRl2tZln9oQzY5lzQwg==", 
    token: "ky1LEdl2B67jPgGDbP9vGW5MRoQO6ESrMcLrqUOz+sFSfyOcxaOh/PIQAzyvZz9H", 
    remark: "ZJAOGrXY+FB9uGP/VBQH+bUko51v+2ZVjjVXJRx6SC5W6OxD8W/jiQ/zYbzxbX9JujHkpxGIdhptZshFzTmhzJiI1Ct2ErUZDOc5J4uD6tc=", 
    time: 1689926243, 
    sign: "7aed1dd79ffde85375b734639f72b661", 
    sign1: "83ed1a8edd6563419cb8201346d6356c"
}

返回参数说明

参数名	类型	说明
code	number	加密的 状态码
num	number	加密的 剩余次数
token	string	加密的 心跳令牌
remark	json	加密的 卡密备注
time	number	时间戳
sign	string	Md5签名 UTF8编码
sign1	string	Md5签名 GBK编码

• sign :【code 剩余次数 心跳令牌 卡密备注 时间戳 项目密钥】按顺序拼接后取Md5

• 务必校验返回的sign签名，签名校验是防止数据窜改行之有效的方法

• 超级防破解介绍

• 卡密备注设置 1个 或 N个云端变量，代码中的关键性参数使用云端变量

• 相关变量参数动态加密传输保存到云端，需要使用的时候通过云端读取解密

• 如何读取和保存云端变量

• 将相关变量名称保存到卡密备注，客户端只有在认证成功的时候服务器才返回加密的卡密备注信息
• 返回的卡密备注信息就是相关的变量名称（1个 或 N个），根据变量名称读写云端变量
• 更多内容请查看云端变量相关开发文档 或 官方相关源码

参数名	类型	说明
gfwz	string	加密的 官方网址选项配置的内容
xzwz	string	加密的 下载网址选项配置的内容
msg	string	加密的 公告信息选项配置的内容
kf	string	加密的 客服信息选项配置的内容
time	number	时间戳
sign	string	UTF8编码的Md5签名
sign1	string	GBK编码的Md5签名

• sign / sign1 :【官方网址 下载网址 公告信息 客服信息 时间戳 项目密钥】按顺序拼接后取Md5

状态码解释

状态码	解释
100	项目停用
101	卡号过期
102	卡号冻结
103	卡号错误
104	设备 I D 不同 / 同时返回官方网址
105	非本项目卡号 / 同时返回对应的下载网址
200	认证成功
201	项目 I D 错误
502	签名过期
503	签名错误