API 请求
API Request 组件用于通过 URL 或 curl 命令构造并发送 HTTP 请求:
- URL 模式:填写一个或多个以逗号分隔的 URL,然后为每个 URL 选择请求方法。
- curl 模式:直接填写要执行的 curl 命令。
你还可以在组件参数中启用更多请求选项和字段。
组件会返回一个包含响应内容的 Data 对象。
如果你需要特定服务的专用 API 组件,请参阅 业务组件。
API Request 参数
有些参数在可视化编辑器中默认处于隐藏状态。 你可以通过组件标题栏菜单中的 控件 来修改全部参数。
| Name | Display Name | Info |
|---|---|---|
| mode | Mode | 输入参数。模式可选 URL 或 curl。 |
| urls | URL | 输入参数。填写一个或多个以逗号分隔的请求 URL。 |
| curl | curl | 输入参数。仅在 curl 模式 下使用。填写完整 curl 命令后,其他组件参数会根据命令参数自动填充。 |
| method | Method | 输入参数。使用的 HTTP 方法。 |
| query_params | Query Parameters | 输入参数。要附加到 URL 后的查询参数。 |
| body | Body | 输入参数。POST、PATCH、PUT 请求发送的 body,以字典形式提供。 |
| headers | Headers | 输入参数。请求头,以字典形式提供。 |
| timeout | Timeout | 输入参数。请求超时时间。 |
| follow_redirects | Follow Redirects | 输入参数。是否跟随 HTTP 重定向。该参数默认关闭(false),以防止公共 URL 通过重定向跳转到内部资源而绕过 SSRF 防护。只有在你信任目标服务器时才建议开启。更多说明请参阅SSRF 防护环境变量。 |
| save_to_file | Save to File | 输入参数。是否将 API 响应保存到临时文件。默认:关闭(false)。 |
| include_httpx_metadata | Include HTTPx Metadata | 输入参数。是否在输出中包含 headers、status_code、response_headers、redirection_history 等属性。默认:关闭(false)。 |