自动生成应用卡密接口

接口地址: https://yz.52tyun.com/api.php?api=kmgen

返回格式: JSON

请求方式: GET/POST

请求示例: https://yz.52tyun.com/api.php?api=kmgen&app=10000&generate_count=2&time_unit=hour 复制示例 跳转示例

请求参数说明:

名称 变量 必填 类型 说明
接口 api GET 填写kmgen
应用 app GET 填写后台应用APPID
卡密类型 card_type GET/POST 可选值:code(默认-时效卡)、single(次数卡)、fen(积分卡)、vip(会员卡)
生成数量 generate_count GET/POST 1-100之间的整数,默认值为1
卡密长度 card_length GET/POST 4-32之间的整数,默认值为10(含自定义前缀长度)
自定义前缀 custom_prefix GET/POST 允许字母、数字、下划线、短横线,最长10位
卡密对应值 valid_value GET/POST 正整数,默认值为1(表示时长倍数或使用次数)
时长单位 time_unit GET/POST 仅card_type=code时有效,可选值:hour(默认-小时卡)、day(天卡)、week(周卡)、month(月卡)、season(季卡)、year(年卡)、longuse(永久卡)
设备限制数 device_limit GET/POST 1-5之间的整数,默认值为1(允许同时使用的设备数量)
时间戳 t GET/POST 如果开启了[时间差效验]需提交此项
数据签名 sign GET/POST 如果开启了[数据签名]需提交此项

返回参数说明:

名称 类型 说明
code String 返回状态码(200为成功,其他为错误码)
appid String 应用唯一标识
card_type String 生成的卡密类型
generated_count Number 实际生成的卡密数量
card_list Array 生成的卡密列表
expire_tips String 卡密有效期提示(仅code类型有值)
remaining_quota Number 生成后剩余的卡密额度

返回示例:

{
    "code":200,
    "msg":{
        "appid":10000,
        "card_type":"code",
        "generated_count":5,
        "card_list":["4IOaKI4UOo",
            "KVPe44oMLU","fUoZXpHotH",
            "R0rj0Y7iUQ","Vq64F6vNA6"],
        "expire_tips":"时长:1小时(单位)",
        "remaining_quota":2549
    },
    "time":1756469903,
    "check":"ca2db895b3a4c1c4f386c175920b7040"
}

错误码格式说明:

名称 类型 说明
101 String 应用不存在
102 String 应用已关闭
171 String 接口维护中
172 String 接口未添加或不存在
123456789

代码示例:

暂未添加示例代码