j9九游会登录/ 云商店/ / / / / / 授权码软件使用统计(可选)
更新时间:2025-10-15 gmt 08:00

授权码软件使用统计(可选)-j9九游会登录

功能介绍

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

100

授权码软件使用信息,最高支持一次性批量上报100个授权码软件使用信息。

usage

表2 usage

参数

是否必选

参数类型

最大字符长度

描述

license

m

string

64

授权码

software_usage_info

m

list

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

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"
}

相关文档

网站地图