当前接口状态 · 正常

用于卡密api封禁操作

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

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

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

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

返回格式: JSON

请求方式: GET/POST

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

请求参数说明:

名称 变量 必填 类型 说明
接口 api GET 填写kmban
应用 app GET 填写后台应用APPID(可选)
卡密 kami GET/POST 填写要封禁的卡密
封禁时长类型 ban_duration_type GET/POST 填写封禁时长类型:hour(小时)/day(天)/week(周)/month(月),不填或填0为永久封禁
封禁时长数值 ban_duration_value GET/POST 填写封禁时长数值,必须大于0(当ban_duration_type不为0时必填)
数据签名 sign GET/POST 如果开启了[数据签名]需提交此项

返回参数说明:

名称 类型 说明
code String 返回状态码,200表示成功
kami String 提交的卡密
ban_type String 封禁类型:permanent(永久封禁) 或 temporary(临时封禁)
ban_duration_type String 封禁时长类型(仅临时封禁时返回):hour/day/week/month
ban_duration_value Integer 封禁时长数值(仅临时封禁时返回)
ban_end_time Integer 封禁结束时间戳(仅临时封禁时返回)
ban_end_date String 封禁结束日期时间(仅临时封禁时返回),格式:Y-m-d H:i:s
remaining_days Integer 剩余天数(仅临时封禁时返回)
remaining_hours Integer 剩余小时数(仅临时封禁时返回)
remaining_minutes Integer 剩余分钟数(仅临时封禁时返回)
message String 操作结果消息
time Integer 服务器时间戳
check String 数据校验值

返回示例:


{
    "code":200,
    "msg":{
        "kami":"cefUniU3n6",
        "ban_type":"temporary",
        "ban_duration_type":"day",
        "ban_duration_value":3,
        "ban_end_time":1756144711,
        "ban_end_date":"2026-01-27 12:00:00",
        "remaining_days":3,
        "remaining_hours":0,
        "remaining_minutes":0,
        "message":"卡密已成功封禁,封禁时长:3 day,预计解封时间:2026-01-27 12:00:00"
    },
    "time":1755883111,
    "check":"bc444b6b37246bd942ca1b356e1f147c"
}


{
    "code":200,
    "msg":{
        "kami":"cefUniU3n6",
        "ban_type":"permanent",
        "message":"卡密已成功永久封禁"
    },
    "time":1755883111,
    "check":"bc444b6b37246bd942ca1b356e1f147c"
}

错误码格式说明:

名称 类型 说明
101 String 应用不存在
102 String 应用已关闭
171 String 接口维护中
172 String 接口未添加或不存在
104 String 签名为空
105 String 数据过期
106 String 签名有误
148 String 卡密不能为空
149 String 卡密不存在
201 String 卡密封禁失败,请重试
204 String 无效的封禁时长类型或封禁时长数值必须大于0
169 String IP不一致

代码示例:


                        

点我进群