j9九游会登录/ 云商店/ / / / / / 查询授权码（必选）
更新时间：2025-07-03 gmt 08:00

查询授权码（必选）-j9九游会登录

功能介绍

  • 该接口为原“授权码心跳检测”，商家进行授权码的激活后，用户每日首次使用license软件时，商家需要调用该接口，若不使用则无需调用。
  • 商家通过该接口实时查询授权码的状态、过期时间等信息，并通过该信息控制license软件的生命周期以及客户端的使用。

uri

旧版接口

post https://mkt.myhuaweicloud.com/api/mkp-openapi-public/global/v1/license/heartbeat

新版接口

post https://mkt.myhuaweicloud.com/api/mkp-openapi-public/global/v2/license/heartbeat

  • 仅支持https协议，“mkt.myhuaweicloud.com”域名不可用时请使用“mkt.myhuaweicloud.cn”进行重试。
  • 新版接口支持批量查询授权码，商家可以按照自身业务场景选择“新版”和“旧版”接口进行调用，只需调测任意一个版本的接口，都满足接入要求。
  • 需要对mkt.myhuaweicloud.com https证书进行强校验，不能忽略证书校验，从而保证调用的是真实而非伪造的云商店服务。

旧版接口参数信息

表1 请求参数

参数

是否必选

参数类型

最大字符长度

描述

license

m

string

64

授权码id

heartbeatinfo

o

heartbeatinfo

/

心跳检测信息

注意：

该字段已日落，上报软件使用情况请对接“授权码软件使用统计”接口，已接入的license软件可继续使用。

heartbeatinfo为json格式，支持扩充，云商店会校验关键key必输，对于已经对接过该接口的商家，云商店会保持对以往版本的兼容。

表2 heartbeatinfo

参数

是否必选

参数类型

最大字符长度

描述

thirdparty account

m

string

256

三方系统用户唯一标识（代表商家软件内可以代表终端用户唯一性的字符串，如账号id、设备码等）

ip

o

string

32

客户登录的ip地址

请求示例

{
    "license" : "plxxxxxx",
    "heartbeatinfo":{
        "thirdpartyaccount":"myaccount1",
        "ip":"192.168.1.51"
    }
}

响应消息

表3 响应参数

参数

是否必选

参数类型

最大字符长度

描述

error_code

m

string

16

结果码。

error_msg

m

string

1024

结果消息。

data

m

licenseinfo

/

授权码信息

licenseinfo为json格式，支持扩充字段，对于已经对接过该接口的商家，当响应字段增加，需要保持兼容。

表4 licenseinfo

参数

是否必选

参数类型

最大字符长度

描述

license_code

m

string

64

授权码

status

m

string

10

授权码状态

alive-正常

expired-过期

released-已释放

activate_time

m

string

16

激活时间，utc时间，格式：yyyymmddhhmmss

real_effect_time

m

string

16

交付完成时间（软件生效时间），utc时间，格式：yyyymmddhhmmss

expire_time

o

string

16

过期时间，utc时间，格式：yyyymmddhhmmss

一次性订单无过期时间

product_name

m

string

128

商品名称

product_id

m

string

128

产品标识，同一skucode下，不同周期类型的product_id不同。

例如：商家发布产品，新增一个规格，会生成一个skucode，再配置包年、包月价格，会生成两个product_id。

说明：

该参数可在商品审核上架后，进入"卖家中心>商品管理>我的商品"页面，单击该商品操作列的“详情”进入详情页查看。

order_id

m

string

64

订单号

amount

o

integer

7

数量类型的商品定价属性
成功响应示例 
http/1.1 200 ok 
content-type: application/json;charset=utf-8 
content-length: length 
date: response time  
{ 
    "error_code": "92020000", 
    "error_msg": "success" ,
    "data": {
       "license_code": "pl********01",
       "status": "alive",
       "activate_time": "20230519024731",
       "real_effect_time": "20230619024731",
       "expire_time": null,
       "product_name": null,
       "product_id": null，
       "order_id": null,
       "amount": null
    }
}

失败响应示例

http/1.1 401 unauthorizedcontent-type: application/json;charset=utf-8content-length: lengthdate: response time 
{ 
    "error_code": "92020001", 
    "error_msg": "unauthorized"
}

新版接口参数信息

表5 请求参数

参数

是否必选

参数类型

最大字符长度

描述

license_list

m

string[]

100

授权码，最高支持一次性批量查询100个授权码。

请求示例

{
     "license_list" : ["pl****001","pl****002","pl****003"]
}

响应消息

表6 响应参数

参数

是否必选

参数类型

最大字符长度

描述

error_code

m

string

16

结果码。

error_msg

m

string

1024

结果消息。

data

m

licenseinfo[]

/

授权码信息

licenseinfo为json格式，支持扩充字段，对于已经对接过该接口的商家，当响应字段增加，需要保持兼容。

表7 licenseinfo

参数

是否必选

参数类型

最大字符长度

描述

license_code

m

string

64

授权码

status

m

string

10

授权码状态

alive-正常

expired-过期

released-已释放

invalid-不合法的授权码

activate_time

m

string

16

激活时间，utc时间，格式：yyyymmddhhmmss

real_effect_time

m

string

16

交付完成时间（软件生效时间），utc时间，格式：yyyymmddhhmmss

expire_time

o

string

16

过期时间，utc时间，格式：yyyymmddhhmmss

一次性订单无过期时间

product_name

m

string

128

商品名称

product_id

m

string

128

产品标识，同一skucode下，不同周期类型的product_id不同。

例如：商家发布产品，新增一个规格，会生成一个skucode，再配置包年、包月价格，会生成两个product_id。

说明：

该参数可在商品审核上架后，进入"卖家中心>商品管理>我的商品"页面，单击该商品操作列的“详情”进入详情页查看。

order_id

m

string

64

订单号

amount

o

integer

7

数量类型的商品定价属性
成功响应示例 
http/1.1 200 ok 
content-type: application/json;charset=utf-8 
content-length: length 
date: response time  
{
    "error_code": "92020000",
    "error_msg": "success",
    "data": [
        {
            "license_code": "pl*****01",
            "status": "alive",
            "activate_time": "20230519024731",
            "real_effect_time": "20230619024731",
            "expire_time": null,
            "product_name": null,
            "product_id": null,
            "order_id": null,
            "amount": null
        },
        {
            "license_code": "pl*****02",
            "status": "alive",
            "activate_time": "20230519024731",
            "real_effect_time": "20230619024731",
            "expire_time": null,
            "product_name": null,
            "product_id": null,
            "order_id": null,
            "amount": null
        },
        {
            "license_code": "pl*****03",
            "status": "invalid"
        },
        {
            "license_code": "pl*****04",
            "status": "invalid"
        }
    ]
}

失败响应示例

http/1.1 401 unauthorizedcontent-type: application/json;charset=utf-8content-length: lengthdate: response time 
{ 
    "error_code": "92020001", 
    "error_msg": "unauthorized"
}
父主题：

相关文档

网站地图