授权码软件使用统计(可选)
功能介绍
- 商家进行授权码的激活后,每日首次使用License软件时,商家需要调用该接口进行上报软件使用信息,若不使用则无需调用。
- 在公有云销售的联营License商品必须对接此接口。
URI
POST https://mkt.myhuaweicloud.com/api/mkp-openapi-public/global/v2/license/software-usage-info

- 仅支持https协议,“mkt.myhuaweicloud.com”域名不可用时请使用“mkt.myhuaweicloud.cn”进行重试。
请求消息
参数 |
是否必选 |
参数类型 |
最大字符长度 |
描述 |
---|---|---|---|---|
usage_info |
M |
List<Usage> |
100 |
授权码软件使用信息,最高支持一次性批量上报100个授权码软件使用信息。 |
Usage
参数 |
是否必选 |
参数类型 |
最大字符长度 |
描述 |
---|---|---|---|---|
license |
M |
String |
64 |
授权码 |
software_usage_Info |
M |
List<SoftwareUsageInfo> |
100 |
软件使用信息 |
参数 |
是否必选 |
参数类型 |
最大字符长度 |
描述 |
备注 |
---|---|---|---|---|---|
id |
O |
String |
256 |
客户端登录标识,如账号ID、设备码等(用于区分不同的客户端,统计活跃数量) |
注意:
每次上报,software_usage_Info的可选参数必选其一且只能选其一 |
active_num |
O |
interger |
9 |
当日总计活跃客户端数量 |
请求注意事项:
- 需要对mkt.myhuaweicloud.com HTTPS证书进行强校验,不能忽略证书校验,从而保证调用的是真实而非伪造的云商店服务。
请求示例
例子1: { "usage_info": [ { "license": "PLXXXXXX", "software_usage_Info": [ { "id": "account1" //客户端标识(用于区分不同的客户端,统计活跃数量) } ] } ] } 例子2: { "usage_info": [ { "license": "PLXXXXXX", "software_usage_Info": [ { "active_num": 100 //或当日总计活跃客户端数量 } ] } ] }
响应消息
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
error_code |
M |
String |
16 |
结果码。 |
error_msg |
M |
String |
1024 |
结果消息。 |
data.check_fail_list |
O |
List<String> |
100 |
校验存在异常的授权码 |
例子1:全部上报成功 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "92020000", "error_msg": "success" } 例子2:部分授权码校验失败 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "92020020", "error_msg": "Invalid license code exists.", "data": { "check_fail_list": ["PL****001","PL****002","PL****003"] } }
失败响应示例
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=UTF-8Content-Length: lengthDate: response time { "error_code": "92020001", "error_msg": "Unauthorized" }