当前接口状态 · 正常
用于卡密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不一致 |
代码示例: