当前接口状态 · 正常
用于api进行进行生成卡密,无需在管理后台进行操作,快速操作!
接口地址: https://yz.jilicun.com/api.php?api=generatekami
备用接口: https://yz1.jilicun.com/api.php?api=generatekami
海外接口: https://www.ban365.com/api.php?api=generatekami
返回格式: JSON
请求方式: GET/POST
请求示例: https://yz.jilicun.com/api.php?api=generatekami&app=10000 复制示例 跳转示例
请求参数说明:
| 名称 | 变量 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 接口 | api | 是 | GET | 填写generatekami |
| 应用 | app | 是 | GET | 填写后台应用APPID |
| 卡密类型 | type | 是 | GET/POST | code(单码卡密)、single(次数卡密)、vip(会员兑换卡)、fen(积分兑换卡)、svipcard(至尊卡) |
| 卡密数值 | amount | 是 | GET/POST | 根据类型不同含义不同:单码卡密为时长、次数卡密为次数、会员卡为天数、积分卡为积分数 |
| 时长类型 | km_time | 条件必填 | GET/POST | type=code时必填,可选值:hour(小时)、day(天)、week(周)、month(月)、season(季)、year(年)、longuse(永久)、vipcard(贵宾) |
| 生成数量 | km_num | 否 | GET/POST | 默认1,最大100 |
| 卡密长度 | km_length | 否 | GET/POST | 默认10,范围6-32 |
| 卡密前缀 | km_prefix | 否 | GET/POST | 自定义前缀,最长10个字符 |
| 卡密结构 | km_structure | 否 | GET/POST | 0=默认,1=大小写混合,2=小写,3=大写,4=数字,5=小写+数字,6=大写+数字,7=国际标准(混合),8=国际标准(大写) |
| 代理UID | agent_uid | 否 | GET/POST | 传入后启用代理模式,代理UID |
| 支付方式 | paytype | 否 | GET/POST | 代理模式使用,1=账户余额(默认),2=充值余额 |
| 时间戳 | t | 否 | GET/POST | 如果开启了[时间差效验]需提交此项 |
| 数据签名 | sign | 否 | GET/POST | 如果开启了[数据签名]需提交此项 |
返回参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| code | String | 返回状态 |
| success_count | Int | 成功生成的卡密数量 |
| failed_count | Int | 生成失败的数量 |
| total_count | Int | 请求生成的总数量 |
| deducted | Int | 本次扣除的卡密额度 |
| remaining | Int | 扣费后剩余的卡密额度 |
| kamis | Array | 生成的卡密列表 |
返回示例:
{
"code": 200,
"msg": {
"success_count": 10,
"failed_count": 0,
"total_count": 10,
"deducted": 10,
"remaining": 990,
"kamis": [
"JLC_A1B2C3D4E5F6",
"JLC_G7H8I9J0K1L2",
"JLC_M3N4O5P6Q7R8",
"JLC_S9T0U1V2W3X4",
"JLC_Y5Z6A7B8C9D0",
"JLC_E1F2G3H4I5J6",
"JLC_K7L8M9N0O1P2",
"JLC_Q3R4S5T6U7V8",
"JLC_W9X0Y1Z2A3B4",
"JLC_C5D6E7F8G9H0"
]
},
"time": 1735545600,
"check": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}
错误码格式说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| 101 | String | 应用不存在 |
| 102 | String | 应用已关闭 |
| 171 | String | 接口维护中 |
| 172 | String | 接口未添加或不存在 |
| 100 | String | 应用配置未加载 |
| 104 | String | 签名为空 |
| 105 | String | 数据过期 |
| 106 | String | 签名有误 |
| 148 | String | 参数为空或缺失 |
| 163 | String | 参数格式错误或不支持 |
| 201 | String | 生成卡密失败 |
| 201 | String | 卡密额度不足 |
代码示例:
.版本 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, "")