1. 内置节点
专属集成平台
  • 快速开始
    • 集成平台概览
  • 身份与用户管理
    • 用户管理
      • 用户与组织架构管理
    • 角色管理
      • 角色管理配置说明
    • 属性管理
      • 属性管理配置说明
      • IDAAS 扩展物理字段使用说明
    • 上游身份数据集成
      • 通讯录身份集成概述
      • 集成连接器配置指南
        • 通讯录集成-泛微
        • 通讯录集成-飞书
        • 通讯录集成-企业微信
        • 通讯录集成-AD
        • 通讯录集成-睿人事
        • 通讯录集成-北森
        • 通讯录集成-SCIM
        • 通讯录集成-用友EHR
        • 通讯录集成-Azure AD
        • 通讯录集成-致远
        • 通讯录集成-LDAP
        • 通讯录集成-数据库
        • 通讯录集成-钉钉
          • 基础说明
          • 钉钉集成连接器如何配置属性映射
      • 通过连接流实现身份集成
        • 在连接流画布中完成身份集成配置
      • 身份集成常见问题
        • 常见问题 & 排错指南
    • 下游身份数据同步
      • 通讯录同步概述
      • 同步连接器配置指南
        • 通讯录同步-企业微信
        • 通讯录同步-AD
        • 通讯录同步-用友U8C
        • 通讯录同步-钉钉
          • 基础说明
          • 如何配置部门职位扩展字段
      • 通过连接流实现身份同步
        • 使用连接流实现身份下游同步
      • 身份同步常见问题
        • 常见问题 & 排错指南
        • 使用代理网关进行身份同步
  • 认证源管理
    • 认证源基础说明
      • 认证源选型说明
      • 认证源管理概述
    • 认证源配置指南
      • 基础协议配置
        • 认证源-CAS协议
        • 认证源-OIDC协议
        • 认证源-OAuth2协议
      • 三方认证源配置手册
        • 认证源-钉钉
        • 认证源-AD
        • 认证源-飞书
        • 认证源-LDAP
        • 认证源-微信
        • 认证源-微信公众号
        • 认证源-Google Workspace
        • 认证源-AD Azure
        • 认证源-美云智数
        • 认证源-企业微信
  • 应用管理
    • 基础说明
      • 应用管理概述
      • 应用创建与配置
    • 应用单点登录
      • 单点登录概述
      • 单点登录配置
      • 单点登出配置
      • 授权范围配置
      • 自定义集成单点登录配置说明
      • 应用密码代填
      • 应用网关
      • 单点登录配置指南
        • 单点登录-OIDC
        • 单点登录-SAML协议
        • 单点登录-OAuth2
        • 单点登录-CAS协议
        • 单点登录-钉钉SSO
        • 单点登录-分贝通
        • 单点登录-用友NCC
        • 单点登录-宜搭
        • 单点登录-泛微OA
        • 单点登录-致远OA
        • 单点登录-金蝶云星空
        • 单点登录-中国电子云邮箱
        • 单点登录-阿里云控制台(RAM)
        • 单点登录-纷享销客应用
        • 单点登录-纷享销客待办
        • 单点登录-Exchange
        • Exchange-双入口配置指南
    • 应用授权管理
      • 应用授权概述
      • 基于组织架构和用户授权
      • 基于角色授权(RBAC)
      • 基于用户属性授权(ABAC)
      • 用户自主申请应用(OA审批授权)权限
    • 应用分发
      • 企业应用分发
      • ABM应用分发
    • 使用应用调用集成平台 OPENAPI
      • M2M接口授权
      • 接口调用权限配置说明
  • 连接中心
    • 产品概述
      • 什么是 AI 连接流
      • AI 连接流的典型使用场景
    • 基础功能
      • 流程运行日志
      • 功能概览
      • 如何创建 AI 工作流
      • 授权凭证管理
      • 错误处理
    • 节点说明
      • 节点基础类型说明
      • 数据处理节点
        • 文本处理节点
        • 数组处理
        • 数据集合节点
      • 文件处理节点
        • 「Base64 转 URL」动作说明
        • 「PPT分页切割」动作说明
      • 应用节点
        • Teambition
        • 金蝶云 K3Cloud
      • 内置节点
        • 子流程调用
        • 缓存处理
        • 分支节点
        • 循环执行
        • MYSQL 触发动作说明
        • 数字签名
        • Webhook触发
        • 缓存列表处理
        • 条件分支
        • FTP
        • 延时节点
        • 模型子节点
        • MCP SERVER 工具
        • 邮件发送
        • 存储子节点
        • 工具子节点
        • HTTP 请求
        • 变量节点
        • 加解密节点
        • 返回变量
      • 运维管理节点
        • 数据校验节点
      • AI节点
        • 构建你的第一个 AI Agent
        • AI 浏览器操作节点
        • AI Agent节点使用指南
        • AI 消息对话节点 & 组件嵌入
  • 审计日志
    • 管理员行为日志
    • 用户变更日志
    • 接口调用日志
    • 用户行为日志
    • 消息发送日志
  • 权限中心
    • 管理员账号管理
    • 管理员角色管理
  • 品牌设置
    • 登录页设置
      • 登录页面配置
      • 登录页CSS自定义页面样式
      • CSS定制页面内容:样式修改指南及故障排除
    • 短信设置
      • 短信模板配置
      • 短信服务使用及签名修改使用指南
      • 短信服务-自定义连接流配置
      • 阿里云短信网关配置指引
    • 邮件设置
      • 邮件模板配置
      • 通过自定义连接流发送邮件
      • SMTP 配置与测试支持文档
    • 企业消息设置
      • 企业消息配置
      • 企业消息(钉钉_飞书)配置
    • 分发页面设置
      • 分发页面设置
  • 平台设置
    • 功能概述
    • 授权管理
    • 代理网关
    • 授权信息
    • 登录策略配置
      • 弱密码检测功能说明
      • 登录流程配置
      • 自动登录功能配置
    • MFA 配置
      • MFA基础配置
      • 使用连接流自定义 MFA 策略
    • 运维日志
      • 运维日志下载
  • 最佳实践
    • AD-LDAP接入指南
    • 第三方平台应用创建指南
      • 钉钉
        • 钉钉全套集成指南
        • 创建钉钉开放平台应用
      • 飞书
        • 飞书全套集成指南
        • 创建飞书开放平台应用
      • 企微
        • 企业微信全套集成指南
        • 创建企业微信开放平台应用
  • 开放接口
    • 鉴权认证
      • 获取access_token(请求体方式)
      • 获取access_token(Basic认证方式)
    • 用户管理
      • 查询用户
      • 创建用户
      • 根据多个条件过滤并查询用户信息
      • 根据用户帐号获取用户信息
      • 修改用户
      • 启用/禁用用户
      • 删除用户
      • 修改用户密码
    • 组织部门
      • 获取组/部门的列表
      • 创建组/部门
      • 根据组/部门ID获取组/部门的信息
      • 修改组/部门
      • 删除组/部门
      • 根据组/部门ID获取下级组/部门信息
      • 过滤部门信息
    • 角色管理
      • 创建角色
      • 获取单个角色详情
      • 修改角色
      • 删除角色
      • 查询角色列表
      • 根据应用ID和用户ID获取角色列表
      • 查看角色所对应的用户列表
      • 给多个用户添加静态角色
      • 删除用户静态角色
      • 获取用户的角色信息
    • 连接中心
      • Webhook启动连接流
    • 事件通知
      • 连接器事件通知
  1. 内置节点

HTTP 请求

概述#

HTTP请求处理器,用于执行各种HTTP API调用。通过配置请求参数,可以实现RESTful API的完整交互,支持GET、POST、PUT、DELETE等方法,以及复杂的参数传递和响应处理。

功能特性#

多种HTTP方法:支持GET、POST、PUT、DELETE、PATCH等标准HTTP方法
灵活参数配置:支持Path、Query、Header、Body等多种参数类型
认证集成:支持OAuth、Basic Auth等认证方式
响应处理:自动解析JSON/XML响应,支持自定义成功判断
代理支持:支持HTTP代理和虚拟IP
编码处理:支持UTF-8、GBK等多种字符编码

配置参数#

HttpAction#

基础配置#

httpMethod:HTTP方法(GET/POST/PUT/DELETE/PATCH)
endpoint:API端点URL
contentType:内容类型(如application/json)
responseType:响应类型(JSON/XML/TEXT)
encoding:响应编码(UTF8/GBK)

认证配置#

accountId:账号ID(用于缓存)
authProtocol:认证协议类型
account:认证账号信息

代理配置#

proxyIp:代理IP地址

参数配置#

path:路径参数(Map<String, Object>)
query:查询参数(Map<String, Object>)
header:请求头(Map<String, Object>)
body:请求体(Object)

成功判断#

successCondition:成功条件列表
successExp:成功表达式(JavaScript)

使用方法#

1. 基本GET请求#

{
  "httpMethod": "GET",
  "endpoint": "https://api.example.com/users",
  "responseType": "JSON",
  "query": {
    "page": 1,
    "size": 10
  },
  "header": {
    "Authorization": "Bearer ${token}"
  }
}

2. POST请求提交数据#

{
  "httpMethod": "POST",
  "endpoint": "https://api.example.com/users",
  "contentType": "application/json",
  "body": {
    "name": "张三",
    "email": "zhangsan@example.com",
    "age": 25
  },
  "successCondition": [
    {
      "field": "code",
      "operator": "eq",
      "value": 200
    }
  ]
}

3. 带路径参数的请求#

{
  "httpMethod": "GET",
  "endpoint": "https://api.example.com/users/{userId}/profile",
  "path": {
    "userId": "${user.id}"
  }
}

4. 文件上传请求#

{
  "httpMethod": "POST",
  "endpoint": "https://api.example.com/upload",
  "contentType": "multipart/form-data",
  "body": {
    "file": "${fileData}",
    "metadata": {
      "name": "document.pdf",
      "type": "pdf"
    }
  }
}

5. 带认证的请求#

{
  "httpMethod": "GET",
  "endpoint": "https://api.example.com/secure-data",
  "accountId": "oauth_account_001",
  "authProtocol": "OAUTH2",
  "account": {
    "clientId": "client_123",
    "clientSecret": "secret_456",
    "tokenUrl": "https://auth.example.com/token"
  }
}

执行逻辑#

参数构建#

1.
从节点上下文解析配置参数
2.
构建HttpAction对象
3.
设置代理IP和认证信息

请求执行#

1.
组装请求头(自动添加Content-Type)
2.
处理路径参数替换
3.
准备查询参数和请求体
4.
调用认证服务执行HTTP请求

响应处理#

1.
解析HTTP响应
2.
转换为HttpOutput格式
3.
检查成功条件
4.
设置节点执行状态

成功判断机制#

条件判断#

通过successCondition配置判断请求是否成功:
{
  "successCondition": [
    {
      "field": "statusCode",
      "operator": "eq",
      "value": 200
    },
    {
      "field": "body.success",
      "operator": "eq",
      "value": true
    }
  ]
}

表达式判断#

通过successExp使用JavaScript表达式判断:
{
  "successExp": "response.body.code === 0 && response.statusCode < 300"
}

响应输出#

HttpOutput结构#

{
  "httpStatus": 200,
  "header": {
    "content-type": "application/json",
    "server": "nginx"
  },
  "body": {
    "code": 0,
    "message": "success",
    "data": {...}
  }
}

输出变量#

httpStatus:HTTP状态码
header:响应头对象
body:响应体内容

高级功能#

动态参数替换#

支持使用变量进行参数替换:
{
  "endpoint": "https://api.example.com/users/${userId}",
  "query": {
    "token": "${authToken}",
    "timestamp": "${currentTime}"
  }
}

批量请求#

结合循环节点实现批量API调用:
Loop (遍历用户列表)
├── HttpAction (调用用户API)
└── VarAction (收集结果)

错误重试#

配置重试策略处理临时失败:
{
  "retryConfig": {
    "maxRetries": 3,
    "retryDelay": 1000,
    "retryConditions": ["500", "502", "503"]
  }
}

响应缓存#

启用响应缓存提高性能:
{
  "cacheConfig": {
    "enabled": true,
    "ttl": 300,
    "key": "${endpoint}_${query}"
  }
}

性能优化#

连接池管理#

HTTP连接复用
连接超时配置
最大连接数限制

并发控制#

请求频率限制
并发请求控制
队列管理

最佳实践#

1. 请求配置#

使用合适的HTTP方法
设置正确的Content-Type
配置合理的超时时间

2. 错误处理#

实现完善的成功判断逻辑
处理各种HTTP错误码
配置适当的重试策略

3. 安全考虑#

使用HTTPS协议
妥善处理敏感信息
验证SSL证书

4. 性能调优#

启用连接复用
使用合适的并发数
监控请求耗时

调试和监控#

请求日志#

记录完整的请求参数
输出响应状态和内容
记录执行耗时

性能指标#

请求成功率
平均响应时间
错误分布统计

常见问题#

Q: 如何处理不同格式的响应?#

A: 通过responseType参数指定响应格式:
JSON:自动解析为对象
XML:解析为XML文档
TEXT:作为字符串处理

Q: 支持哪些认证方式?#

A: 支持多种认证方式:
Basic Auth
Bearer Token
OAuth 2.0
API Key
自定义认证
修改于 2026-05-07 01:44:57
上一页
工具子节点
下一页
变量节点
Built with