Skip to main content

使用 PHP SDK 运行

当你想从 PHP 调用工作流部署时,请使用官方的 fetch-hive/sdk Composer 包。SDK 包装了公共的 POST /v1/workflow/invoke 端点,处理身份验证,并同时支持直接响应和回调投递。

安装

该 SDK 需要 PHP 8.1+,并使用 Guzzle 作为其 HTTP 客户端。

身份验证

FETCH_HIVE_API_KEY 环境变量设置为你的工作区 API 密钥(客户端会自动读取它):
或显式传入密钥:
有关如何创建和轮换密钥,请参阅 API 密钥

基本示例

直接运行工作流部署。该调用会阻塞,直到工作流完成:
请参阅 直接响应结构

方法参考

invokeWorkflow 会为你构建请求体。当你传入 async_mode: true 时,SDK 会发送:

处理响应

回调投递

传入 async_mode: true 以立即返回,并让 Fetch Hive 在运行完成时调用你的回调 URL:
请保存 webhook_secret,以便你能验证传入回调的签名。请参阅 回调投递与 Webhook 触发 了解验证流程和签名负载结构。

配置

错误

非 2xx 响应会抛出 FetchHive\Sdk\Exception\ApiException,其中包含状态码和响应体:
有关工作流特有的失败案例,请参阅 错误处理;有关 HTTP 状态码含义,请参阅 错误与速率限制

链接

后续步骤