简介

API 所有调用接口域名都为 GET 方式。域名为：http://api.2018k.cn/v3

• 通用返回格式:

字段名	说明
success	返回 true 或 false，代表请求成功或失败
message	返回的消息内容，一般为错误信息
data	接口返回数据
code	错误码，请求成功为 0

• 如果返回数据为加密数据,请使用 AES 解密 data 字段

查询软件信息

GET/obtainSoftware

这个API 返回所有软件必要的信息,包括网络验证信息

请求参数返回json

https://api.2018k.cn/v3/obtainSoftware?softwareId=D89D27701067437AA9C9EA1AD8A00159&machineCode=123456

• softwareId: 软件ID
• machineCode: 机器码, 可以不传, 不传时只能查出软件信息

返回参数字段参考】

字段名	说明
softwareId	软件 ID
versionNumber	服务器版本号
softwareName	软件名称
versionInformation	更新内容
notice	软件公告
downloadLink	下载地址
numberOfVisits	访问数量（该数量不准确，非实时数据）
miniVersion	最低版本号
isItEffective	卡密当前状态是否有效（一般用于判断是否注册）
expirationDate	卡密过期时间，时间戳
remarks	卡密备注
numberOfDays	卡密有效期类型，卡密有效期天数
networkVerificationId	卡密 ID
timeStamp	服务器时间，时间戳
mandatoryUpdate	是否强制更新
softwareMd5	软件 MD5

创建一个卡密

GET/createNetworkAuthentication

使用API创建一个卡密

请求参数返回json

https://api.2018k.cn/v3/createNetworkAuthentication?softwareId=D89D27701067437AA9C9EA1AD8A00159&info=U2FsdGVkX1/IDLWvtBciYkkIOYCewx6T83Z7+HGBL9oiV8roRLBK21HU4ej9EJ3SCUslk4GK3cArmtWPvzZlvbRuw0bOs2qjVyG3Pawoct0=

• softwareId: 软件ID
• info: 加密后的数据, 加密数据为{"day":7,"remark":"通过卡密创建","times":1728549074204} }

• info 加密数据参考:

请使用 json 将其加密后传给 info 字段

字段名	说明
day	卡密天数
remark	卡密备注
times	当前时间戳

激活/注册一个卡密

GET/activation

注册卡密(激活),传入一个卡密ID,并激活他

请求参数返回json

https://api.2018k.cn/v3/activation?authId=926B9C1C545B40C0A4ABF06FAEBD6226&softwareId=D89D27701067437AA9C9EA1AD8A00159&machineCode=BFEBFBFF000A0653

• softwareId: 软件ID
• authId: 卡密ID
• machineCode: 机器码

卡密换绑和解绑

GET/replaceBind

卡密解绑和换绑, 传入一个卡密ID,和机器码(不传为解绑)

请求参数返回json

https://api.2018k.cn/v3/replaceBind?softwareId=D89D27701067437AA9C9EA1AD8A00159&info=U2FsdGVkX1++zYptyCCv+UYORhl7ii5RAkTcAYnMOravQ8FhkgMyiYG5oFlg8IaYfa2r8wNiKw0u8G735UZSB/7PFU1BZ5wdWu7g9lEO9a+q4WtU4dxhDnLBUtew81E3

• softwareId: 软件ID
• info: 加密数据 { "authId": "926B9C1C545B40C0A4ABF06FAEBD6226", "machineCode": "123"}

• info 加密数据参考:

请使用 json 将其加密后传给 info 字段

字段名	说明
authId	卡密 ID
machineCode	机器码，不传视为解绑

发送事件消息

• 消息文本 需要 URL 编码，推荐使用精易模块 编码_URL编码_JS()

GET/messageSend

发送事件消息,事件消息在后台可以看到

请求参数返回json

https://api.2018k.cn/v3/messageSend?softwareId=D89D27701067437AA9C9EA1AD8A00159&message=%D2%BB%B8%F6%D3%C3%BB%A7%B5%E3%BB%F7%C1%CB%B0%B4%C5%A5

• softwareId: 软件ID
• message: 消息内容, 需要使用URL编码，否则乱码

获取云变量

GET/getCloudVariables

获取云变量

请求参数返回json

https://api.2018k.cn/v3/getCloudVariables?softwareId=68f0bf1a9aa3446aad90c21b399eab2f

• softwareId: 软件ID

• 返回了加密信息,需要使用 AES 解密

易语言代码