j9九游会登录/ 云商店/ / / / / / 激活授权码(必选)
更新时间:2025-05-22 gmt 08:00

激活授权码(必选)-j9九游会登录

功能介绍

用户购买联营license商品后,订单进入服务监管流程,授权码会同时发给商家和客户,商家的软件集成该接口,对授权码进行激活处理,实现客户使用软件的统一生命周期管理。

uri

旧版接口

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

新版接口

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

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

旧版接口参数信息

表1 请求参数

参数

是否必选

参数类型

最大字符长度

描述

license

m

string

64

授权码

real_effect_time

o

string

16

实际交付时间(软件的生效时间)

取utc时间,格式:yyyymmddhhmmss

注意:

不能小于客户下单时间。

请求示例

{
    "license" : "plxxxxxx"
}

响应消息

表2 响应参数

参数

是否必选

参数类型

最大字符长度

描述

error_code

m

string

16

结果码。

error_msg

m

string

1024

结果消息。

data

o

license

/

授权码信息

表3 license

参数

是否必选

参数类型

最大字符长度

描述

license_code_info

m

string

1024

json字符串,包含以下参数:status状态(alive-正常)、expire_time(过期时间)、product_id(产品id)、order_id(订单号)、amount(数量类型的商品定价属性)。

注意:

该参数expire_time有效期为估值,和授权码实际有效期有差别,请以授权码心跳检测接口返回的状态和有效期为准。

成功响应示例

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_info": "{\"status\":\"alive\",\"expire_time\":\"20230726121646\",\"product_id\":\"12345\",\"amount\":2,\"order_id\":\"cs123\"}"
}
}

失败响应示例

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

新版接口参数信息

表4 请求参数

参数

是否必选

参数类型

最大字符长度

描述

license_list

m

string[]

100

授权码,最高支持一次性批量激活100个授权码。

real_effect_time

o

string

16

实际交付时间(软件的生效时间)

取utc时间,格式:yyyymmddhhmmss

注意:

不能小于客户下单时间。

请求示例

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

响应消息

表5 响应参数

参数

是否必选

参数类型

最大字符长度

描述

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

相关文档

网站地图