云商店-新购商品:响应消息
下载云商店用户手册完整版
响应消息
响应参数说明请参见下表：
参数 |
是否必选 |
类型 |
最大字符长度 |
参数说明 |
|---|---|---|---|---|
resultCode |
M |
String |
6 |
调用结果码。 具体请参见调用结果码说明。 |
resultMsg |
O |
String |
255 |
调用结果描述。 |
encryptType |
O |
String |
3 |
敏感信息加密算法 1：AES256_CBC_PKCS5Padding（默认值） 2：AES128_CBC_PKCS5Padding 说明：
敏感信息加密算法是AES256_CBC_PKCS5Padding时返回值为1，敏感信息加密算法是AES128_CBC_PKCS5Padding时返回值为2。 |
instanceId |
M |
String |
64 |
实例ID，商家提供的唯一标识。 建议此ID直接使用该订单首次请求时云商店传入的businessId，以确保instanceId的唯一性。 说明：
云商店每次请求时的businessId皆不一致，如取businessId作为instanceId，取订单首次调用时的businessId即可。 若通过其他方式生成instanceId，请确保该参数的全局唯一性，例如使用UUID生成。避免生成的instanceId发生重复，导致用户开通SaaS实例失败。 |
appInfo |
O |
AppInfo |
N/A |
应用实例信息。 客户购买商品后，商家需要返回登录服务地址（网站地址）或免登地址供客户后续操作。 说明：
SaaS商品必须向客户提供应用使用信息，包括使用地址、账号、密码等。 如可实现通过短信、邮件等其他方式发送使用信息，则接口中允许不响应；否则，必须在接口中返回应用实例信息。 如使用信息不仅包含使用地址及账号密码，可通过如下memo参数灵活返回其他使用信息或使用说明等。 appInfo数据结构定义请参见下表。 |
AppInfo数据结构定义如下：
参数 |
是否必选 |
类型及范围 |
最大字符长度 |
参数说明 |
|---|---|---|---|---|
frontEndUrl |
M |
String |
512 |
前台地址。 客户购买商品后，可以访问的网站地址。 |
adminUrl |
O |
String |
512 |
管理地址。 客户购买商品后，可以访问的管理后台地址。 |
userName |
O |
String |
128 |
加密后的管理员账号。 客户购买商品后，访问商家管理后台的账号（一般为邮箱和手机号）。该值由16位iv加密向量和base编码后的用户名密文组成。 iv+encryptAESCBCEncode(userName, accessKey, iv, keySize) 需要使用Key值对账号做加密处理，加密算法以encryptType参数为准。代码示例请参见ISV Server对资源开通后的用户名和密码加密。 |
password |
O |
String |
128 |
加密后的管理员初始密码。 客户购买商品后，访问商家管理后台的密码（一般由商家生成）。该值由16位iv加密向量和base编码后的密码密文组成。 iv+encryptAESCBCEncode(password, accessKey, iv, keySize) 需要使用Key值对密码做加密处理，加密算法以encryptType参数为准。代码示例请参见ISV Server对资源开通后的用户名和密码加密。 |
memo |
O |
String |
1024 |
备注。 说明：
如果备注包含中文内容，请将中文转换成unicode编码，例如：“中文”可以转换成“\u4e2d\u6587”。 |
- 获取accessKey，请参见获取Key值。
- 用户名密码所校验的长度是密文的长度（包括iv向量）。
- 商家的服务器在处理接口请求时，需要做好幂等性处理。
云商店服务有可能重发请求，针对同一订单号，商家的服务器应当返回成功的响应及应用实例信息，不应该创建新的SaaS实例，返回之前成功创建的实例信息即可。
- SaaS实例信息如果有变化，例如，adminUrl发生变化，在云商店服务重新调用此接口，传入相同的orderId时，商家的服务器需要返回更新后的SaaS实例信息。为保证安全，云商店不持久存储SaaS实例信息。
- ISV生产接口响应中，除memo参数外，其他参数请不要返回中文。
响应消息示例：
{
"resultCode":"000000",
"resultMsg":"success.",
"instanceId":"03pf80c2bae96vc49b80b917bea776d7",
"encryptType":"1",
"appInfo":{
"frontEndUrl":"https://marketplace.huaweicloud.com/",
"adminUrl":"https://marketplace.huaweicloud.com",
"userName":"luQ***TobyT***Rx***pwMRg==",
"password":"7Bx***5***hC***atExg=="
}
}
