变更授权码状态
接口说明
用户购买的商品过期且超过宽限期,云商店调用该接口时,商家应冻结该授权码对应的资源。
- 云商店调用该接口时,商家需要保障接口通畅,将该授权码对应的资源进行冻结或解冻,如接口调用失败,可能导致该授权码对应的资源仍可使用或不可使用。
- 针对商品过期且未续费场景下,接口调用失败的情况,云商店会持续调用60次(每2分钟1次)后停止调用,重试频率为2分钟一次,“卖家中心>生产接口消息”中可查询接口“异常信息”。商家修复接口异常后,在云商店对该失败调用进行重新调用。
- 请注意查看商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件后及时处理接口异常。
- 云商店会对接口异常的情况做监控,如License商品频繁出现接口异常的情况,云商店将对该商品做下架处理。
变更授权码状态流程如下图所示:
流程说明如下:
- License类商品过期,未续费;
- 调用变更授权码状态接口;
- 冻结授权码对应的资源;
- 返回变更授权码状态结果。
请求消息
请求参数说明请参见下表:
请求方法:POST
参数 |
是否必选 |
类型 |
最大字符长度 |
说明 |
---|---|---|---|---|
activity |
M |
String |
32 |
接口请求标识,用于区分接口请求场景。 变更授权码状态场景取值:updateLicenseCodeStatus |
license |
M |
String |
64 |
授权码 |
status |
M |
String |
32 |
变更状态:
|
testFlag |
O |
String |
2 |
是否为调试请求。
默认取值为“0”。 |
请求消息示例:
{ "activity":"updateLicenseCodeStatus", "license":"******", "status":"FREEZE", "testFlag":"1" }
响应消息
响应参数说明请参见下表:
参数 |
是否必选 |
类型 |
最大字符长度 |
说明 |
---|---|---|---|---|
resultCode |
M |
String |
6 |
调用结果码。 具体请参见调用结果码说明。 |
resultMsg |
O |
String |
255 |
调用结果描述。 |
响应消息示例:
{ "resultCode":"000000", "resultMsg":"success." }