使用 Ruby SDK 运行
当你想从 Ruby 调用工作流部署时,请使用官方的fetch_hive gem。SDK 包装了公共的 POST /v1/workflow/invoke 端点,处理身份验证,并同时支持直接响应和回调投递。
安装
添加到你的Gemfile:
faraday,支持 Ruby 3.0+。
身份验证
将FETCH_HIVE_API_KEY 环境变量设置为你的工作区 API 密钥(客户端会自动读取它):
基本示例
直接运行工作流部署。该调用会阻塞,直到工作流完成:方法参考
invoke_workflow 会为你构建请求体。当你传入 async_mode: true 时,SDK 会发送:
处理响应
回调投递
传入async_mode: true 以立即返回,并让 Fetch Hive 在运行完成时调用你的回调 URL:
webhook_secret,以便你能验证传入回调的签名。请参阅 回调投递与 Webhook 触发 了解验证流程和签名负载结构。
配置
错误
非 2xx 响应会引发RuntimeError,其中包含状态码和响应体。如需处理失败,请捕获异常:
链接
后续步骤
- 回调投递与 Webhook 触发 - 验证回调签名
- 使用 API 运行 - 使用 cURL 的相同流程
- 使用 Python SDK 运行
- 使用 Node.js SDK 运行
- 使用 PHP SDK 运行
- 调用工作流 - 完整端点参考

