当前接口状态 · 正常

使用api进行快速导入卡密

  • API文档
  • 错误码参照
  • 示例代码

接口地址： https://yz.jilicun.com/api.php?api=importkami

备用接口： https://yz1.jilicun.com/api.php?api=importkami

海外接口： https://www.ban365.com/api.php?api=importkami

返回格式： JSON

请求方式： GET/POST

请求示例： https://yz.jilicun.com/api.php?api=importkami&app=10000 复制示例 跳转示例

请求参数说明：

名称 变量 必填 类型 说明
接口 api 是 GET 填写importkami
应用 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(贵宾)
卡密列表 kamis 是 GET/POST 卡密列表，支持字符串（换行/逗号/分号分隔）或数组格式，单次最多500个
代理UID agent_uid 否 GET/POST 传入后启用代理模式，代理UID
支付方式 paytype 否 GET/POST 代理模式使用，1=账户余额（默认），2=充值余额
时间戳 t 否 GET/POST 如果开启了[时间差效验]需提交此项
数据签名 sign 否 GET/POST 如果开启了[数据签名]需提交此项

返回参数说明：

名称 类型 说明
code String 返回状态
success_count Int 成功导入的卡密数量
duplicate_count Int 重复的卡密数量
failed_count Int 导入失败的数量
total_count Int 提交的总数量
deducted Int 本次扣除的卡密额度
refunded Int 退还的卡密额度（重复+失败）
remaining Int 扣费后剩余的卡密额度
success_kamis Array 成功导入的卡密列表
duplicate_kamis Array 重复的卡密列表
failed_kamis Array 导入失败的卡密列表（包含失败原因）

返回示例：

{
    "code": 200,
    "msg": {
        "success_count": 8,
        "duplicate_count": 2,
        "failed_count": 0,
        "total_count": 10,
        "deducted": 10,
        "refunded": 2,
        "remaining": 988,
        "success_kamis": [
            "KAMI001",
            "KAMI002",
            "KAMI003",
            "KAMI004",
            "KAMI005",
            "KAMI006",
            "KAMI007",
            "KAMI008"
        ],
        "duplicate_kamis": [
            "KAMI009",
            "KAMI010"
        ],
        "failed_kamis": []
    },
    "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=importkami
.参数 卡密类型, 文本型, , code(单码卡密)、single(次数卡密)、vip(会员兑换卡)、fen(积分兑换卡)、svipcard(至尊卡)
.参数 卡密数值, 整数型, , 根据类型不同含义不同
.参数 时长类型, 文本型, 可空, type=code时必填，可选值：hour、day、week、month、season、year、longuse、vipcard
.参数 卡密列表, 文本型, , 卡密列表，支持换行、逗号、分号分隔，单次最多500个
.参数 数据传输, 整数型, 可空, 留空或填写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 ＝ 独立秘钥
.如果真结束

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

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

签名SIGN ＝ 校验_取md5_文本 ("type=" ＋ 卡密类型 ＋ "&amount=" ＋ 到文本 (卡密数值) ＋ "&km_time=" ＋ 时长类型 ＋ "&kamis=" ＋ 卡密列表 ＋ "&t=" ＋ 到文本 (时间_到时间戳 (, 真, 真)) ＋ "&" ＋ APPKEY_yz_jilicun_com, 真)
yun_VALUE ＝ 到文本 (取随机数 (1000, 99999)) ＋ 到文本 (时间_到时间戳 (, , ))
yun_DATA ＝ "type=" ＋ 卡密类型 ＋ "&amount=" ＋ 到文本 (卡密数值) ＋ "&km_time=" ＋ 时长类型 ＋ "&kamis=" ＋ 卡密列表 ＋ "&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=importkami&app=" ＋ APPID_yz_jilicun_com ＋ "&" ＋ yun_DATA, 0, , , , , , , , , , , , )))

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

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

.如果结束

返回 (结果)


' 使用示例1：导入多个天卡（换行分隔）
' 卡密列表文本 = "KAMI001" + #换行符 + "KAMI002" + #换行符 + "KAMI003"
' 结果 = 导入卡密("code", 7, "day", 卡密列表文本, 0, "")

' 使用示例2：导入多个次数卡（逗号分隔）
' 结果 = 导入卡密("single", 50, "", "KAMI001,KAMI002,KAMI003", 0, "")

' 使用示例3：导入会员卡（分号分隔）
' 结果 = 导入卡密("vip", 30, "", "VIP001;VIP002;VIP003", 0, "")

点我进群