SaaS 类商品 SPI 开发指南

 

接口概述

更新时间 2023-09-06

服务商接入 SaaS 类商品到云市场,需要进行 SPI 对接,根据本指南实现 SPI 相关的接口定义。

调用场景

客户购买商品后,云市场通过调用 SaaS 服务商提供的 SPI 以满足实例创建、续费、删除等场景。

SPI 所需覆盖的场景与对应事件名称如下表所示。

场景 事件名称
实例创建 CreateInstance
实例续费 RenewInstance
实例升级 UpgradeInstance
实例过期 ExpireInstance
实例删除 DeleteInstance
测试连接 TestConnection

调用方式

通信协议

支持通过 HTTP 或 HTTPS 通道进行请求通信。为了获得更高的安全性,推荐使用 HTTPS 通道发送请求。

请求地址

创建商品时输入的通知 URL。

请求方法

请求方法为 GET

请求参数

所有参数均使用 Query Params 进行传递,其中 action 参数用于区分场景事件,signaturetimestamp 参数用于校验请求合法性,详见接口安全

响应规则

“响应时间 <=15s && 响应码 == 200 && 响应体格式 == json ”时判定为调用成功,否则判定为调用失败。

重试机制

接口调用失败时,云市场会按照以下规则进行重试。

说明

服务商可根据去重字段来保障接口的幂等性。

事件名称 重试次数 去重字段
CreateInstance 3 order_id
RenewInstance 3 order_id
UpgradeInstance 3 order_id
ExpireInstance 3 instance_id
DeleteInstance 3 instance_id
TestConnection 2
这篇文档解决了您的问题吗?
0
0