Appearance
单码以卡充卡 POST
用一张未激活的单码卡密,为一张已激活的卡密充值时长。
请求方法:
POSTContent-Type:application/x-www-form-urlencoded
以卡充卡说明
- 被充卡密(
target_kami)— 必须是已激活的单码卡密,接收时长(允许已过期,过期后从当前时间起算) - 充值卡密(
source_kami)— 必须是未激活的单码卡密,提供时长
充值成功后:
- 被充卡的到期时间累加充值卡的时长
- 充值卡绑定被充卡的机器码
- 充值卡标记为已激活 + 已到期(不可再次使用)
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
target_kami | string | 必填 | 被充卡密(已激活) |
source_kami | string | 必填 | 充值卡密(未激活) |
t | number | 条件必填 | 秒级 Unix 时间戳 |
s | string | 条件必填 | 请求签名 |
safe_code | string | 可选 | 数据验证码 |
成功响应
jsonc
{
"code": "200", // 状态码
"msg": "充值成功" // 结果消息
}txt
充值成功错误列表
业务错误
| 错误消息 | 原因 |
|---|---|
被充卡密不可为空 | 未传 target_kami |
充值卡密不可为空 | 未传 source_kami |
被充卡密和充值卡密不可相同 | 两张卡密相同 |
被充卡密不存在 | 被充卡密不存在 |
被充卡密被禁用 | 被充卡密已被禁用 |
被充卡密未激活 | 被充卡密尚未激活 |
充值卡密不存在 | 充值卡密不存在 |
充值卡密被禁用 | 充值卡密已被禁用 |
充值卡密已被使用 | 充值卡密已被激活使用 |
通用错误
| 错误消息 | 原因 |
|---|---|
程序未开启 / 接口未开启 | 程序或接口未启用 |
时间戳参数不可为空 | 开启时间戳验证但未传 t |
验证数据已失效,请重试 | 时间戳校验失败(排障指南) |
签名参数不可为空 | 开启签名验证但未传 s |
签名有误 | 签名校验失败 |