Dify Docs home page
简体中文
Search...
⌘K
Ask AI
Blog
Dify
Dify
Search...
Navigation
节点说明
HTTP 请求
使用文档
插件开发
访问 API
资源
入门
欢迎使用 Dify
云服务
Dify 社区版
Dify Premium
Dify 教育版
访问 API
手册
接入大模型
构建应用
工作流
工作流
关键概念
变量
节点说明
开始
LLM
知识检索
问题分类
条件分支
代码执行
模板转换
文档提取器
列表操作
变量聚合
变量赋值
迭代
参数提取
HTTP 请求
Agent
工具
结束
直接回复
循环
快捷键
编排节点
文件上传
异常处理
附加功能
预览与调试
应用发布
结构化输出
变更公告:图片上传被替换为文件上传
知识库
工具
发布
标注
监测
扩展
协同
管理
动手实验室
简介
初级
中级
社区
寻求支持
成为贡献者
为 Dify 文档做出贡献
插件
功能简介
快速开始
插件管理
接口定义
最佳实践
发布插件
常见问题
研发
DifySandbox
模型接入
迁移
阅读更多
应用案例
扩展阅读
常见问题
政策
开源许可
用户协议
On this page
定义
场景
高级功能
节点说明
HTTP 请求
Copy page
定义
允许通过 HTTP 协议发送服务器请求,适用于获取外部数据、webhook、生成图片、下载文件等情景。它让你能够向指定的网络地址发送定制化的 HTTP 请求,实现与各种外部服务的互联互通。
该节点支持常见的 HTTP 请求方法:
GET
,用于请求服务器发送某个资源。
POST
,用于向服务器提交数据,通常用于提交表单或上传文件。
HEAD
,类似于 GET 请求,但服务器不返回请求的资源主体,只返回响应头。
PATCH
,用于在请求-响应链上的每个节点获取传输路径。
PUT
,用于向服务器上传资源,通常用于更新已存在的资源或创建新的资源。
DELETE
,用于请求服务器删除指定的资源。
你可以通过配置 HTTP 请求的包括 URL、请求头、查询参数、请求体内容以及认证信息等。
场景
这个节点的一个实用特性是能够根据场景需要,在请求的不同部分动态插入变量。比如在处理客户评价请求时,你可以将用户名或客户ID、评价内容等变量嵌入到请求中,以定制化自动回复信息或获取特定客户信息并发送相关资源至特定的服务器。
HTTP 请求的返回值包括响应体、状态码、响应头和文件。值得注意的是,如果响应中包含了文件,这个节点能够自动保存文件,供流程后续步骤使用。这样不仅能提高处理效率,也可以更加简单直接地处理带有文件的响应。
发送文件
你可以使用 HTTP PUT 请求将应用内的文件发送至其它 API 服务。在请求的 Body 中,可以在
binary
内选中文件变量。这种方式常用于文件传输、文档存储或媒体处理等场景。
示例: 假设你正在开发一个文档管理应用,需要将用户上传的 PDF 文件同步发送第三方服务,可以通过 HTTP 请求节点通过文件变量进行传递。
配置示例如下:
高级功能
错误重试
针对节点发生的部分异常情况,通常情况下再次重试运行节点即可解决。开启错误重试功能后,节点将在发生错误的时候按照预设策略进行自动重试。你可以调整最大重试次数和每次重试间隔以设置重试策略。
最大重试次数为 10 次
最大重试间隔时间为 5000 ms
异常处理
HTTP 节点处理信息时有可能会遇到网络请求超时、请求限制等异常情况。应用开发者可以参考以下步骤配置异常分支,在节点出现异常时启用应对方案,而避免中断整个流程。
在 HTTP 节点启用 “异常处理”
选择异常处理方案并进行配置
需了解更多应对异常的处理办法,请参考
异常处理
。
编辑此页面
|
提交问题
Was this page helpful?
Yes
No
参数提取
Agent
Assistant
Responses are generated using AI and may contain mistakes.