文档首页/ 云商店/ 接入指南/ 商品接入相关接口/ 联营License客户端软件对接指南/ 在线开通License接入指南/ 接口描述/ 异步申请License
更新时间：2023-12-25 GMT+08:00
查看PDF
分享

异步申请License

接口说明

用户通过云商店向商家申请License。

  • 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。
  • 云商店会对接口异常的情况做监控，如商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。
  • 云商店服务有可能重发请求，针对同一请求，商家的服务器应当返回相同的License，不应该创建新的License，返回之前成功创建的License即可。

申请License流程如下图所示：

上传License流程如下图所示：

请求消息

请求参数说明请参见下表：

请求方法：POST

参数

是否必选

类型

取值范围

说明

activity

M

String

20

接口请求标识，用于区分接口请求场景。

异步申请License场景取值：getLicenseAsync

instanceId

M

String

64

业务资源实例ID

effectiveTime

M

String

32

License生效utc时间

expireTime

O

String

32

License失效utc时间，包周期类型必输

eventId

M

String

64

云商店业务流水号，用于商家服务器结合设备指纹，区分是否是同一次申请License的请求，支持License传输中断等业务需要重试的场景

deviceFingerprint

O

String

1024

设备指纹或硬件识别编码，用于需要绑定设备物理标识信息生成License的场景

testFlag

O

String

2

是否为调试请求。

  • 1：调试请求
  • 0：非调试请求

默认取值为“0”。

请求消息示例：

curl -X POST 'https://www.isvwebsite.com/saasproduce?signature=11C4C*********31DEF5C515*******B8A3A6D8******7A48&timestamp=1680508066618&nonce=50D83FDECAED6CCD8EF597F2A577950527928BA287D04E6036E92B2806FD17DA' -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -d'{"activity":"getLicenseAsync","eventId":"8****e5694*****c8","instanceId":"RA2****4LVS","effectiveTime":"2023-10-27 10:30:15 z","expireTime":"2024-10-27 10:30:15 z","deviceFingerprint":"8******6034e2*****60e1"}'

响应消息

响应参数说明请参见下表：

参数

是否必选

类型

取值范围

说明

resultCode

M

String

6

调用结果码。

  • 000000：表示资源同步开通
  • 000004：表示资源异步开通

具体请参见《调用结果码说明》。

resultMsg

O

String

255

调用结果描述。
  • 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。
  • 云商店会对接口异常的情况做监控，如商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。

响应消息示例：

{  
    "resultCode":"000000",  
    "resultMsg":"success."  
}
父主题： 接口描述

相关文档