跳到主要内容

收到 HTTP 请求时

云开发工作流支持通过小程序、App 或第三方服务发起的 HTTP 请求来触发一个流程。同时也支持将流程中生成或计算后的数据作为 HTTP 响应返回,即作为 HTTP API Service 来使用。

配置项说明

是否启用

是否启用该触发方式,关闭后无法再通过 HTTP 请求触发工作流。

接收推送 URL

接收 HTTP 请求的 URL。使用 POST 方法发送请求到该地址即可触发工作流。该 URL 已包含下方配置项【路径】。

路径

指定接送推送请求 URL 中的路径(Path)部分,默认随机生成,可以手动进行修改。支持多级路径,例如:a/b/c

使用示例

使用 curl 命令触发

你可以使用 curl 命令来发送 HTTP 请求以触发工作流。

提示

需要使用配置项中的【接收推送 URL】替换下方示例中的 <WebhookURL>

不携带任何参数

curl -X POST <WebhookURL>

携带 Body 参数

curl -X POST <WebhookURL> -d '{ "key": "value" }' -H 'Content-Type:application/json'

携带 Header 参数

curl -X POST <WebhookURL> -H 'key1:value1'

指定 HTTP 响应数据

默认情况下,通过 HTTP 请求成功触发的工作流,在运行完成后会返回固定的数据:

{
"message": "flow executed successfully"
}

你可以通过使用 响应 HTTP 请求 节点,返回指定的响应数据。操作步骤如下:

  1. 在右侧操作面板 节点列表 中,将 响应 HTTP 请求 节点拖入画布中
  2. 将该节点与其他流程节点连线
  3. 配置节点,参考文档