文档首页> 云商店> 接入指南> SaaS类商品接入指南 V2.0> 基础接口描述> 实例升级
更新时间：2024-05-16 GMT+08:00
查看PDF
分享

实例升级

接口说明

用户对已购买的资源进行升级，升级订单付款成功后，云商店调用该接口请求商家升级用户购买的资源，商家接口需要执行资源升级，并记录用户升级后的产品数据。

商品升级流程如下图所示：

请求消息

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

请求方法：POST

参数

是否必选

类型

取值范围

说明

activity

M

String

32

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

升级场景取值：upgradeInstance

instanceId

M

String

64

实例ID。

说明：

升级时，instanceId不变。

orderId

M

String

64

升级后的新订单ID。

说明：

升级操作会产生新的订单。

orderLineId

M

String

64

云商店订单行ID。

testFlag

O

String

2

是否为调试请求。

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

默认取值为“0”。

请求消息示例：

curl -X POST 'https://www.isvwebsite.com/saasproduce?signature=9D49F9BF09D69F7A98B847978D6091A9ADF3B40E07AF95FEE9E5BEF5218DA407&timestamp=1680510876429&nonce=D8FE86FA6ABE90CA63A72B3256743D3D869648FE99A96354E635F032629F6C21' -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -d'{"activity":"upgradeInstance","instanceId":"10e758d0-31ad-4c4b-8f1b-81d03469a10e","orderId":"CS2211181819B4LVS","orderLineId":"CS2211181819B4LVS-000001","testFlag":"0"}'

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

参数

是否必选

类型

取值范围

说明

resultCode

M

String

6

调用结果码。

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

resultMsg

O

String

255

调用结果描述。

响应消息示例：

{ 
    "resultCode":"000000", 
    "resultMsg":"success." 
}

HTTP Body签名:

Body-Sign: sign_type="HMAC-SHA256", signature= "xxxxxxxxxxxxx" ，详情参考《HTTP Body签名》。

父主题： 基础接口描述
分享：

    相关文档

    相关产品