文档首页/ 云商店/ 接入指南/ 商品接入相关接口/ 联营License类授权码商品接入指南（2.0版本）/ 云商店开放接口描述/ 接口列表/ 授权码心跳检测
更新时间：2024-04-12 GMT+08:00
查看PDF
分享

授权码心跳检测

功能介绍

商家进行授权码的激活后，用户每日首次使用License软件时，商家需要调用该接口，若不使用则无需调用。

URI

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

仅支持https协议。

“mkt.myhuaweicloud.com”域名不可用时请使用“mkt.myhuaweicloud.cn”进行重试。

请求消息

表1 请求参数

参数

是否必选

参数类型

最大字符长度

描述

license

M

String

64

授权码（新授权码对接商品传过来的是授权码,存量线上License商品也会调用该接口，传instanceId即可）

heartbeatInfo

M

HeartbeatInfo

   

心跳检测信息

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

表2 HeartbeatInfo

参数

是否必选

参数类型

最大字符长度

描述

thirdParty Account

M

String

256

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

ip

O

String

32

客户登录的IP地址

请求注意事项：

需要对mkt.myhuaweicloud.com HTTPS证书进行强校验，不能忽略证书校验，从而保证调用的是真实而非伪造的云商店服务。

请求示例

{
    "license" : "PLXXXXXX",
    "heartbeatInfo":{
        "thirdPartyAccount":"myaccount1",
        "ip":"192.168.1.51"
    }
}

响应消息

表3 响应参数

参数

是否必选

参数类型

最大字符长度

描述

error_code

M

String

16

结果码。

error_msg

M

String

1024

结果消息。

data

O

LicenseInfo

      

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

表4 LicenseInfo

参数

是否必选

参数类型

最大字符长度

描述

status

M

String

10

授权码状态

ALIVE-正常

EXPIRED-过期

RELEASED-已释放

activate_time

M

String

16

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

expire_time

M

String

16

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

product_name

M

String

128

商品名称

product_id

M

String

128

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

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

说明：

该参数可在商品审核上架后，进入"卖家中心>商品管理>我的商品"页面，单击该商品操作列的“详情”进入详情页查看。
成功响应示例 
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": {
       "status": "ALIVE",
       "activate_time": "20230519024731",
       "expire_time": null,
       "product_name": null,
       "product_id": null
    }
}

失败响应示例

HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=UTF-8Content-Length: lengthDate: response time 
{ 
    "error_code": "92020001", 
    "error_msg": "Unauthorized"
}

父主题： 接口列表

相关文档