错误码格式说明：

代码示例：

.版本 2

.子程序 生成卡密, 文本型, 公开, 批量生成卡密，官网开发文档：https://yz.jilicun.com/doc.php?act=generatekami
.参数 卡密类型, 文本型, , code(单码卡密)、single(次数卡密)、vip(会员兑换卡)、fen(积分兑换卡)、svipcard(至尊卡)
.参数 卡密数值, 整数型, , 根据类型不同含义不同
.参数 时长类型, 文本型, 可空, type=code时必填，可选值：hour、day、week、month、season、year、longuse、vipcard
.参数 生成数量, 整数型, 可空, 默认1，最大100
.参数 卡密长度, 整数型, 可空, 默认10，范围6-32
.参数 卡密前缀, 文本型, 可空, 自定义前缀，最长10个字符
.参数 数据传输, 整数型, 可空, 留空或填写0默认全局数据传输方式，填写1则数据传输独立设置RC4加密，填写2则数据传输独立设置不加密
.参数 独立秘钥, 文本型, 可空, 默认全局RC4KEY初始秘钥，填写则独立配置RC4KEY
.局部变量 yun_VALUE, 文本型
.局部变量 yun_DATA, 文本型
.局部变量 结果, 文本型
.局部变量 KEY, 文本型
.局部变量 签名SIGN, 文本型

' APPID_yz_jilicun_com为全局变量---应用后台APPID秘钥
' APPKEY_yz_jilicun_com为全局变量---应用后台APPKEY秘钥
' RC4KEY_yz_jilicun_com为全局变量---应用后台数据传输RC4秘钥
KEY ＝ RC4KEY_yz_jilicun_com
.如果真 (独立秘钥 ≠ "")
    KEY ＝ 独立秘钥
.如果真结束

.如果真 (卡密类型 ＝ "")
    返回 ("卡密类型为空")
.如果真结束

.如果真 (生成数量 ＝ 0)
    生成数量 ＝ 1
.如果真结束

.如果真 (卡密长度 ＝ 0)
    卡密长度 ＝ 10
.如果真结束

签名SIGN ＝ 校验_取md5_文本 ("type=" ＋ 卡密类型 ＋ "&amount=" ＋ 到文本 (卡密数值) ＋ "&km_time=" ＋ 时长类型 ＋ "&km_num=" ＋ 到文本 (生成数量) ＋ "&km_length=" ＋ 到文本 (卡密长度) ＋ "&km_prefix=" ＋ 卡密前缀 ＋ "&t=" ＋ 到文本 (时间_到时间戳 (, 真, 真)) ＋ "&" ＋ APPKEY_yz_jilicun_com, 真)
yun_VALUE ＝ 到文本 (取随机数 (1000, 99999)) ＋ 到文本 (时间_到时间戳 (, , ))
yun_DATA ＝ "type=" ＋ 卡密类型 ＋ "&amount=" ＋ 到文本 (卡密数值) ＋ "&km_time=" ＋ 时长类型 ＋ "&km_num=" ＋ 到文本 (生成数量) ＋ "&km_length=" ＋ 到文本 (卡密长度) ＋ "&km_prefix=" ＋ 卡密前缀 ＋ "&t=" ＋ 到文本 (时间_到时间戳 (, 真, 真)) ＋ "&sign=" ＋ 签名SIGN ＋ "&value=" ＋ yun_VALUE

.如果 (数据传输 ＝ 0)
    .如果真 (数据加密_yz_jilicun_com ＝ 1)
        yun_DATA ＝ "data=" ＋ RC4加密 (yun_DATA, KEY)
    .如果真结束

.否则
    .如果真 (数据传输 ＝ 1)
        yun_DATA ＝ "data=" ＋ RC4加密 (yun_DATA, KEY)
    .如果真结束

.如果结束

结果 ＝ 删除空字符 (UTF8到文本 (网页_访问 (#URL ＋ "/api.php?api=generatekami&app=" ＋ APPID_yz_jilicun_com ＋ "&" ＋ yun_DATA, 0, , , , , , , , , , , , )))

.如果 (数据传输 ＝ 0)
    .如果真 (数据加密_yz_jilicun_com ＝ 1)
        结果 ＝ RC4解密 (结果, KEY)
    .如果真结束

.否则
    .如果真 (数据传输 ＝ 1)
        结果 ＝ RC4解密 (结果, KEY)
    .如果真结束

.如果结束

返回 (结果)


' 使用示例1：生成10张天卡
' 结果 = 生成卡密("code", 1, "day", 10, 12, "JLC_", 0, "")

' 使用示例2：生成5张次数卡（100次）
' 结果 = 生成卡密("single", 100, "", 5, 10, "", 0, "")

' 使用示例3：生成1张至尊卡
' 结果 = 生成卡密("svipcard", 999999999, "", 1, 16, "VIP_", 0, "")

一、数据加密（后台：应用安全配置 → 数据加密类型）

开启后，请求参数与返回数据都按该算法处理。加密模式下业务参数不再直接放在 URL 上，而是整体加密后作为 data 参数提交；api 与 app 仍放在 URL 上。

二、加密模式下的提交方式（重点）

把业务参数按顺序拼成 k=v&k2=v2 的字符串，整体加密后做 Base64，作为 data 提交：

// 以 kmlogon 为例（字段名与顺序请以本页「示例代码」标签页为准）

// ① 先拼出「参与签名」的参数串
signStr = "kami=" + 卡密 + "&user=" + 用户账号 + "&markcode=" + 机器码 + "&t=" + 时间戳
//   实际形态：kami=AAAA-BBBB-CCCC-DDDD&user=&markcode=00000000000000000000000000000000&t=1789800447

// ② 算出 sign（算法见第三节），连同随机值 value 一起拼进载荷
sign    = MD5( signStr + "&" + APPKEY )
payload = signStr + "&sign=" + sign + "&value=" + 随机值
//   实际形态：kami=AAAA-BBBB-CCCC-DDDD&user=&markcode=00000000000000000000000000000000&t=1789800447&sign=6f1ed002ab5595859014ebf0951522d9&value=32768

// ③ 整体加密后做 URL 编码，作为 data 提交
data = URL编码( Base64( 用配置的算法加密( payload ) ) )
请求  = api.php?api=kmlogon&app=APPID&user=用户账号&data=data
//   实际形态：api.php?api=kmlogon&app=10001&user=&data=j8KdR2mQ9vT1...

重要 每个接口的载荷字段都不一样，上例只是 kmlogon 的形态；请以本页「示例代码」标签页中该接口的拼接方式为准。

注意 user 要同时作为 URL 参数提交（见上例第 ③ 步，官方示例代码也是这么写的）。因为 fen（积分卡）、vip（会员卡）这两类卡密是从 URL 参数读取用户账号的，只放进加密载荷会返回 110　请填写账号。其余业务参数只出现在载荷里即可。

说明 上例是把 sign 一起放进载荷再整体加密（即后台「签名放DATA里」开启，这也是官方示例代码的做法）。若该项关闭，则 sign 不拼进载荷，改为作为独立参数提交：api.php?api=kmlogon&app=你的应用ID&data=加密结果&sign=签名值。

三、数据签名（后台：数据签名开关 / 签名放DATA里）

签名算法为 32 位小写 MD5，签名对象是加密前载荷中的业务参数串（即上例第 ① 步的 signStr，不含 sign 与 value 本身；注意不是 URL 上的参数）：

sign = MD5( signStr + "&" + APPKEY )
// signStr 即上例第 ① 步拼出的 "kami=...&user=...&markcode=...&t=..."
// APPKEY 是该应用的 appkey（注意：不是 rc4_key）
// 参与签名的只有 signStr 里的字段，sign 与 value 自身不参与

// 承接上例：
// MD5("kami=AAAA-BBBB-CCCC-DDDD&user=&markcode=00000000000000000000000000000000&t=1789800447"
//     + "&" + APPKEY)

要点 签名串只包含本次接口用到的键，多带任何参数都会导致 106；服务端比较时会统一转为小写，所以 sign 传大写也能通过。

易错 值为空的参数同样参与签名。例如上例中的 user= 虽然是空值，也会被拼进签名串；漏掉任何一个已提交的字段都会返回 106。

明文模式注意 当加密类型为「不加密」时，服务端参与签名的参数值经过了一层安全过滤，若参数里含 &、'、"、<、> 等字符，签名将对不上。建议加密模式 + 数据签名配合使用。

四、时间差效验

五、调试模式（排查签名专用）

开启后，服务端会把它自己计算签名的原始字符串（尚未 MD5）直接明文输出并中断请求，用于和客户端拼串逐字符比对：

// 开启调试模式后，发任意一次请求（即使不带 sign）
// 服务端直接返回签名原串（下方为示意，实际按本接口载荷字段拼接）：
kami=你的卡密&markcode=你的机器码&t=当前时间戳&你的APPKEY

注意 开启期间所有请求都会停在这一步，排查完请立即关闭。输出内容为明文，与加密设置无关。

六、RSA 非对称加密（加密类型 = 13）

密钥对在后台「应用安全配置」中一键生成，客户端只需内置 公钥。分块规则：明文每 117 字节为一段，每段独立加密后拼接，再整体 Base64；1024 位密钥下每段密文为 128 字节。

安全性说明 响应方向使用「私钥加密」在数学上属于签名而非加密 —— 任何持有公钥的人（即任何拿到客户端的人）都能解开响应，因此该方向只保证完整性与来源，不保证机密性；真正保密的只有请求方向。

七、接口独立配置的优先级

「卡密管理 → 接口列表 → 独立配置」中若开启了安全配置，则该接口的 加密类型 / 数据签名 / 签名放DATA里 / 时间差效验 / rc4_key 以接口级为准，会覆盖应用级设置；密钥类字段（aes_key、aes_iv、RSA 公私钥）与调试模式只有应用级，不受接口配置影响。排查加密异常时请先确认该接口的独立配置状态。

八、常见错误与排查

提示 以上错误响应本身也会按当前加密类型加密，接口返回的是一串密文，请先用相同算法解密再查看具体内容。

签名对不上时的排查清单

1. 开启「调试模式」，拿到服务端签名原串，与客户端拼串逐字符比对
2. 确认参与签名的键只有本次接口用到的那几个，没有多带参数
3. 确认键的顺序与加密前的载荷完全一致
4. 确认用的是应用 appkey，而不是 rc4_key
5. 确认 t 是本次请求的时间戳（若开启了时间差效验）
6. 确认载荷中的值不含 = 与 &（否则字段会被丢弃）
7. 确认接口没有开启「独立配置」覆盖掉应用级的加密/签名设置