卡密查询 接口文档
查询卡密信息,自动判断类型返回到期时间或剩余次数

接口地址: https://mc.wsff.cn/api.php?api=kmquery

返回格式: JSON

请求方式: GET

请求示例: https://xiaor2.wsff.cn/?api=kmquery&app=10000 复制示例 跳转示例

请求参数说明:


名称 变量 必填 类型 说明
接口 api 是 GET 填写kmquery
应用 app 是 GET 填写后台应用APPID
卡密 kami 是 GET/POST 填写需要查询的卡密
邮件通知 email 否 GET/POST 填写任意值则发送邮件通知,不填则不发送
时间戳 t 否 GET/POST 如果开启了[时间差效验]需提交此项
数据签名 sign 否 GET/POST 如果开启了[数据签名]需提交此项

返回参数说明:


名称 类型 说明
code String 返回状态码 200为成功
kami String 卡密
type String 卡密类型 code=时间卡 single=次数卡 fen=积分卡 vip=VIP卡 svipcard=至尊卡 vipcard=会员卡
status String 卡密状态 正常/禁用
create_time String 卡密创建时间
use_time String 卡密使用时间 未使用则显示"未使用"
user String 使用者设备码
user_ip String 使用者IP
expire_time String 到期时间(时间卡/VIP卡/SVIP卡类型) 永久/Y-m-d H:i:s/未使用
end_time Int 到期时间戳(时间卡/VIP卡/SVIP卡类型),永久卡恒为4102243200(未使用也返回永久时间戳),其余类型未使用为0
remaining_times Int 剩余次数(次数卡类型)
fen_amount Int 积分数量(积分卡类型)
member_type String 会员等级(VIP卡/SVIP卡类型):vip=普通VIP会员,svip=SVIP超级会员
time String 请求时间戳
check String 数据校验码

返回示例:

{
    "code": 200,
    "msg": {
        "kami": "2iPMrvyhqH",
        "type": "code",
        "status": "正常",
        "create_time": "2026-08-01 12:00:00",
        "use_time": "2026-08-05 15:30:00",
        "user": "ABC123DEF456",
        "user_ip": "192.168.1.1",
        "expire_time": "2026-09-01 12:00:00",
        "km_time": "month",
        "amount": 1,
        "uns": 1
    },
    "time": 1723456789,
    "check": "00e837c144a02a5ed3717647ee3f33da"
}

错误码格式说明:

名称 类型 说明
101 String 应用不存在
102 String 应用已关闭
171 String 接口维护中
172 String 接口未添加或不存在
104 String 签名为空
105 String 数据过期
106 String 签名有误
148 String 卡密为空
149 String 卡密不存在

代码示例:

.版本 2

.子程序 卡密查询, 文本型, 公开, 查询卡密信息,官网开发文档:https://xiaor2.wsff.cn/doc.php?act=kmquery
.参数 卡密, 文本型, , 需要查询的卡密
.参数 数据传输, 整数型, 可空, 留空或填写0默认全局数据传输方式,填写1则数据传输独立设置RC4加密,填写2则数据传输独立设置不加密
.参数 独立秘钥, 文本型, 可空, 默认全局RC4KEY初始秘钥,填写则独立配置RC4KEY
.局部变量 yun_VALUE, 文本型
.局部变量 yun_DATA, 文本型
.局部变量 查询结果, 文本型
.局部变量 KEY, 文本型
.局部变量 签名SIGN, 文本型

' APPID_yz_wufeng666_cn为全局变量---应用后台APPID秘钥
' APPKEY_yz_wufeng666_cn为全局变量---应用后台APPKEY秘钥
' RC4KEY_yz_wufeng666_cn为全局变量---应用后台数据传输RC4秘钥
KEY = RC4KEY_yz_wufeng666_cn
.如果真 (独立秘钥 ≠ "")
    KEY = 独立秘钥
.如果真结束
.如果真 (卡密 = "")
    返回 ("卡密为空")
.如果真结束
签名SIGN = 校验_取md5_文本 ("kami=" + 卡密 + "&t=" + 到文本 (时间_到时间戳 (, 真, 真)) + "&" + APPKEY_yz_wufeng666_cn, 真)
yun_VALUE = 到文本 (取随机数 (1000, 99999)) + 到文本 (时间_到时间戳 (, , ))
yun_DATA = "kami=" + 卡密 + "&t=" + 到文本 (时间_到时间戳 (, 真, 真)) + "&sign=" + 签名SIGN + "&value=" + yun_VALUE
.如果 (数据传输 = 0)
    .如果真 (数据加密_yz_wufeng666_cn = 1)
        yun_DATA = "data=" + RC4加密 (yun_DATA, KEY)
    .如果真结束
.否则
    .如果真 (数据传输 = 1)
        yun_DATA = "data=" + RC4加密 (yun_DATA, KEY)
    .如果真结束
.如果结束
查询结果 = 删除空字符 (UTF8到文本 (网页_访问 (#URL + "/api.php?api=kmquery&app=" + APPID_yz_wufeng666_cn + "&" + yun_DATA, 0, , , , , , , , , , , , )))
.如果 (数据传输 = 0)
    .如果真 (数据加密_yz_wufeng666_cn = 1)
        查询结果 = RC4解密 (查询结果, KEY)
    .如果真结束
.否则
    .如果真 (数据传输 = 1)
        查询结果 = RC4解密 (查询结果, KEY)
    .如果真结束
.如果结束
返回 (查询结果)