授权码软件使用统计（可选）

功能介绍

商家进行授权码的激活后，每日首次使用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”进行重试。

请求消息

表1 请求参数
参数	是否必选	参数类型	最大字符长度	描述
usage_info	M	List<Usage>	100	授权码软件使用信息,最高支持一次性批量上报100个授权码软件使用信息。

Usage

表2 Usage
参数	是否必选	参数类型	最大字符长度	描述
license	M	String	64	授权码
software_usage_Info	M	List<SoftwareUsageInfo>	100	软件使用信息

表3 SoftwareUsageInfo
参数	是否必选	参数类型	最大字符长度	描述	备注
id	O	String	256	客户端登录标识，如账号ID、设备码等（用于区分不同的客户端，统计活跃数量）	注意：每次上报，software_usage_Info的可选参数必选其一且只能选其一
active_num	O	interger	9	当日总计活跃客户端数量	注意：每次上报，software_usage_Info的可选参数必选其一且只能选其一

请求注意事项：

需要对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
                    //或当日总计活跃客户端数量
                }
            ]
        }
    ]
}

响应消息

表4 响应参数
参数	是否必选	参数类型	取值范围	描述
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"
}

父主题： 云商店授权码开放接口描述

上一篇：查询授权码（必选）

下一篇：测试云商店授权码开放接口