请求参数说明
| 名称 | 变量 | 必填 | 类型 | 说明 |
|---|
| 接口 |
api |
是 |
GET |
填写 getappkm |
| 应用 |
app |
是 |
GET |
填写后台应用 APPID |
| 应用密钥 |
appkey |
是 |
GET/POST |
填写后台应用密钥,须与 app 对应应用一致,防止仅凭应用 ID 拉取卡密 |
| 卡密 |
kami |
否 |
GET/POST |
填写则只查询该卡密是否属于本应用且为可用状态(未使用、未禁用) |
| 卡密类型 |
type |
否 |
GET/POST |
筛选类型:code(单码)、single(次数)、vip(会员)、fen(积分)、svipcard(至尊卡)、vipcard(贵宾卡) 等 |
| 返回条数 |
limit |
否 |
GET/POST |
列表模式下单次最多返回条数,默认 50,最大 200(不传 kami 时生效) |
| 时间戳 |
t |
否 |
GET/POST |
如果开启了[时间差效验]需提交此项 |
| 数据签名 |
sign |
否 |
GET/POST |
如果开启了[数据签名]需提交此项 |
返回参数说明
| 名称 | 类型 | 说明 |
|---|
| code |
Int |
返回状态,200 为成功 |
| total |
Int |
符合条件的可用卡密总数(列表模式为全量统计;单卡查询成功时为 1) |
| count |
Int |
本次实际返回的条数(仅列表模式返回) |
| list |
Array |
卡密列表,每项字段见下表 |
| list.id |
Int |
卡密记录 ID |
| list.kami |
String |
卡密内容 |
| list.type |
String |
卡密类型 |
| list.amount |
String |
卡密数值(时长/次数/天数/积分等,依类型而定) |
| list.km_time |
String |
时长类型(单码卡密:hour/day/week/month 等) |
| list.note |
String |
备注 |
| list.date |
String |
添加时间 |
| time |
Int |
服务器时间戳 |
| check |
String |
校验值 |
返回示例
{
"code": 200,
"msg": {
"total": 128,
"count": 2,
"list": [
{
"id": 1001,
"kami": "ABCD-1234-EFGH-5678",
"type": "code",
"amount": "30",
"km_time": "day",
"note": "",
"date": "2026-05-30 10:00:00"
},
{
"id": 1002,
"kami": "WXYZ-9876-MNOP-4321",
"type": "code",
"amount": "7",
"km_time": "day",
"note": "活动批次",
"date": "2026-05-30 11:30:00"
}
]
},
"time": 1717065600,
"check": "b331c50badb960d997e8f25a78ccb740"
}
错误码格式说明
| 名称 | 类型 | 说明 |
|---|
| 101 |
String |
应用不存在 |
| 102 |
String |
应用已关闭 |
| 171 |
String |
接口维护中 |
| 172 |
String |
接口未添加或不存在 |
| 100 |
String |
应用配置未加载(未传 app 或应用不存在) |
| 101 |
String |
应用不存在 |
| 102 |
String |
应用已关闭 |
| 104 |
String |
签名为空 |
| 105 |
String |
数据过期(时间戳校验失败) |
| 106 |
String |
签名有误 |
| 107 |
String |
加密数据为空 |
| 171 |
String |
接口维护中 |
| 172 |
String |
接口不存在或未购买/未添加 |
| 173 |
String |
接口已过期 |
| 201 |
String |
未提交 appkey / 应用密钥错误 / 指定卡密不存在或不可用 |
代码示例
.版本 2
.子程序 获取应用可用卡密, 文本型, 公开, 获取未使用可用卡密列表,官网开发文档:doc.php?act=getappkm
.参数 返回条数, 整数型, 可空, 单次最多返回条数,默认50,最大200
.参数 卡密类型, 文本型, 可空, 留空返回全部;可填 code、single、vip、fen 等
.参数 查询卡密, 文本型, 可空, 填写则只查该卡密是否可用,不填则返回列表
.局部变量 网址, 文本型
.局部变量 结果, 文本型
.局部变量 json, 类_json
' APPID_www_dujiuyue_cn 为全局变量---应用后台 APPID
' APPKEY_www_dujiuyue_cn 为全局变量---应用后台 APPKEY(本接口必填,与 app 对应)
网址 = #URL + “/api.php?api=getappkm&app=” + APPID_www_dujiuyue_cn + “&appkey=” + APPKEY_www_dujiuyue_cn
.如果真 (返回条数 > 0)
网址 = 网址 + “&limit=” + 到文本 (返回条数)
.如果真结束
.如果真 (卡密类型 ≠ “”)
网址 = 网址 + “&type=” + 卡密类型
.如果真结束
.如果真 (查询卡密 ≠ “”)
网址 = 网址 + “&kami=” + 查询卡密
.如果真结束
结果 = 到文本 (网页_访问 (网址, 0))
json.解析 (结果)
.如果真 (json.取通用属性 (“code”, ) ≠ “200”)
返回 (json.取通用属性 (“msg”, ))
.如果真结束
返回 (结果)
' ---------- HTTP 请求示例(cURL)----------
' GET https://你的域名/api.php?api=getappkm&app=应用id&appkey=getappkm&limit=10
' GET https://你的域名/api.php?api=getappkm&app=应用id&appkey=应用密钥&type=code
' GET https://你的域名/api.php?api=getappkm&app=应用id&appkey=应用密钥&kami=卡密内容