接口路径(新):http://api.okayapi.com/api/App/Market_Kami/Generate
接口路径(旧):http://api.okayapi.com/?s=App.Market_Kami.Generate
接口描述: 生成单个或多个时间卡密。注意,当卡密生成过多时,有可能批量生成的数量不足于指定的数量,建议卡密长度设置长一点,避免碰撞。当不足时,再次请求接口进行生成。使用前请先安装卡密插件
Parameter | Type | Required | Default | Note | Description |
---|---|---|---|---|---|
HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
num | Int | Optaion | 1 | MIN: 1;MAX: 100 | 需要生成的卡密数量 |
expire_seconds | Int | Optaion | 60 | MIN: 60 | 卡密被领取后有效使用时间,单位:秒,例如一天则传86400 |
kami_min_len | Int | Optaion | 6 | MIN: 6 | 卡密的最小字符长度 |
kami_max_len | Int | Optaion | 6 | MIN: 6;MAX: 100 | 卡密的最大字符长度 |
more_data | ArrayJSON Format | Optaion | [] | 更多数据,统一初始化生成时设置的自定义数据,JSON格式,字段为表单字段名称,必须先在表单添加新字段。例如:more_data={"beizhu":"备注数据"} |
请求:
{OKAYAPI_API_HOST}/?s=App.Market_Kami.Generate&num=2&expire_seconds=60&kami_min_len=6&kami_max_len=6
返回:
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"kami_list": [
"m17BfI",
"0WTjFv"
]
},
"msg": "小白开放接口:App.Market_Kami.Generate"
}
KEY | Type | Description |
---|---|---|
err_code | Int | 操作码,0表示成功,9表示插件未安装 |
err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
kami_list | Array | 返回成功创建的卡密列表 |
kami_list[].kami | String | 新的卡密 |
接口路径(新):http://api.okayapi.com/api/App/Market_Kami/Take
接口路径(旧):http://api.okayapi.com/?s=App.Market_Kami.Take
接口描述: 根据时间卡密,判断是否存在,是否已使用,存在返回卡密的有效使用时间。使用前请先安装卡密插件
Parameter | Type | Required | Default | Note | Description |
---|---|---|---|---|---|
HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
kami | String | Required | MIN: 6 | 卡密 | |
kami_client_code | String | Optaion | MAX: 200 | 机器码,可为空。如果最初使用时有传此机器码,则后续需要继续传递此机器码则可以继续使用;并且在初次使用绑定机器码后,其他机器码或空机器码将不能再使用。 | |
more_data | ArrayJSON Format | Optaion | [] | 更多数据,成功使用时设置的更多数据,JSON格式,字段为表单字段名称,可自行添加新字段。例如:more_data={"beizhu":"备注数据"} | |
more_select | ArraySeperated with , | Optaion | 更多返回字段,多个字段用逗号分割。例如:more_select=beizhu |
请求:
{OKAYAPI_API_HOST}/?s=App.Market_Kami.Take&kami=0WTjFv&app_key={你的app_key}&sign={动态签名}
返回:
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"kami_detail": {
"kami_expire_seconds": 60,
"kami_client_code": "abc",
"kami_taken_time": "2019-10-30 15:39:01",
"ip": "",
"kami_expire_time": "2019-10-30 15:40:15"
}
},
"msg": "小白开放接口:App.Market_Kami.Take"
}
KEY | Type | Description |
---|---|---|
err_code | Int | 操作码,0表示成功,1表示卡密不存在,2表示卡密已使用,3表示卡密已过期,4表示机器码不正确,9表示插件未安装 |
err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
kami_detail | Object | 卡密的相关信息 |
kami_detail.kami_expire_time | String | 卡密存在时返回,卡密使用的截止有效日期时间,等于成功领取的时间加上有效使用时间,如:2019-10-30 00:00:19 |
kami_detail.kami_client_code | String | 机器码 |
kami_detail.kami_taken_time | String | 激活时间 |
kami_detail.ip | String | 领取的IP |
kami_detail.kami_expire_seconds | Int | 卡密存在时返回,有效使用时间,相对时间,单位:秒 |
Power by OkayAPI.com Contact us (WA: okayapi OR Email: chanzonghuang@gmail.com).
Timezone: America/New_York Apr/18/2024 11:59:16