文档首页/ 云商店/ 接入指南/ 商品接入相关接口/ 联营License类授权码商品接入指南/ 云商店开放接口描述/ 接口列表/ 激活授权码（必选）
更新时间：2025-05-22 GMT+08:00
查看PDF
分享

激活授权码（必选）

功能介绍

用户购买联营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<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"
}
父主题： 接口列表

相关文档