跳转到主要内容
本文档提供了在将 Runa 作为供应商时,使用 Fluz 礼品卡供应商 API 连接器的具体细节。

原始 Runa API 与 Fluz API 适配器

基础 URL

认证

Runa 基础 URL
  • 使用带有 X-Api-Key 请求头的 API Key 认证

Fluz API 适配器

  • 使用带有 Authorization 请求头的基本认证(与所有供应商集成相同)。

API 端点对比

请求示例

创建订单

原始 Runa 请求:

Fluz API 适配器请求:

Runa 订单的后台处理

通过 Runa 集成进行的所有购买操作都会作为后台操作处理。Fluz API 适配器为 Runa 提供两种响应模式:

同步与异步处理模式

  • 同步模式:
    • 添加请求头 X-Execution-Mode: sync 以等待后台操作完成
    • API 调用将等待直到后台购买操作完成
    • 完整的操作结果会在响应中返回
    • 适用于测试场景,但对复杂购买可能会遇到超时
  • 异步模式(默认):
    • 立即返回一个操作参考 ID
    • 购买会在后台继续处理
    • 之后可使用该参考 ID 调用订单端点查询状态
    • 建议在生产环境使用以避免超时
两种模式都依赖后台处理,但它们在 API 对客户端的响应方式上有所不同。

幂等性支持

原始 Runa API 和 Fluz 的实现都支持幂等性键,以防止重复操作:

使用 cURL 的示例

示例 1:获取特定订单

示例 2:获取所有订单

示例 3:获取所有货币的余额

示例 4:获取 USD 货币余额

示例 5:创建订单(异步模式 - 默认)

示例 6:创建订单(同步模式)