接口名称:状态检查 接口简介:用于定期检查用户卡密状态,维持会话有效性 接口版本号:1.0 接口请求示例:https://yz.xywyz.cn/api.php?api=xyzttaig&app=10000

接口地址: http://yz.xywyz.cn/api.php?api=xyzttaig

返回格式: JSON

请求方式: GET

请求示例: https://yz.xywyz.cn/user/xyzttaig.php?appid=10000 复制示例 跳转示例

请求参数说明:

名称 变量 必填 类型 说明
名称 变量 必填 类型 说明
接口地址 api GET 填写 xyzttaig
应用ID appid GET 填写后台应用APPID
设备码 markcode GET 设备唯一标识码
时间戳 t GET 当前UNIX时间戳
签名 sign GET MD5签名验证
动态密钥 dynamic_key GET 安全验证动态密钥

返回参数说明:

名称 类型 说明
名称 类型 说明
code Integer 返回状态码
msg.status String 授权状态 (valid-有效, trial-试用, expired-过期)
msg.kami String 卡密信息
msg.end_time String 到期时间戳
msg.security_level Integer 安全评分 (0-100)
msg.dynamic_key String 动态安全密钥
time Integer 服务器时间戳
check String 数据校验码

返回示例:

{
    "code": 200,
    "msg": {
        "status": "valid",
        "kami": "VIP123456789",
        "end_time": "4102243200",
        "security_level": 95,
        "dynamic_key": "a1b2c3d4e5f6g7h8"
    },
    "time": 1726932703,
    "check": "093bad3c4ff19e54ab8d913ed98e9e31"
}

错误码格式说明:

名称 类型 说明
101 String 应用不存在
102 String 应用已关闭
171 String 接口维护中
172 String 接口未添加或不存在
错误码 说明 解决方案
200 请求成功 正常使用
100 应用配置错误 检查应用配置
112 设备码参数缺失 补充markcode参数
400 参数错误或设备未授权 检查参数或购买授权
403 应用已关闭或安全验证失败 联系管理员或检查安全配置

代码示例:

PHP 调用示例

验证失败,错误码: 

请求示例URL

http://yz.xywyz.cn/user/xyzttaig.php?appid=10000&markcode=DEVICE123456&t=1726932703&sign=md5签名

安全特性说明

  • 4重安全防护:防本地文件修改、防静态分析、防简单Hook、防时间篡改
  • 动态密钥系统,每次请求生成不同的安全密钥
  • 多重签名验证,防止请求伪造
  • 时间戳验证,防止重放攻击