更新时间:2025-05-22 GMT+08:00
分享

授权码软件使用统计(可选)

功能介绍

  • 商家进行授权码的激活后,每日首次使用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

当日总计活跃客户端数量

请求注意事项

  • 需要对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"
}

相关文档