NueForm

数据节点

在表单流程中发起 HTTP API 调用,用于获取数据、验证答案或触发外部操作。

数据节点允许您的表单在流程中发起 HTTP API 调用。它们对填写者不可见——会自动执行,可从外部 API 获取数据、根据后端验证答案,或触发操作。

数据节点在所有套餐中均可用,且不计入表单中的可见问题数量。

添加数据节点

  1. 在构建器中打开您的表单。
  2. 点击 + 添加新问题。
  3. 从"高级"分类中选择 数据节点
  4. 在问题属性中配置 HTTP 请求。

配置

HTTP 方法

根据您的 API 端点选择 GETPOSTPUTDELETE

URL

要调用的端点 URL。支持变量插值——使用 {variableName} 插入表单变量值。

示例https://api.example.com/users/{email}

如果填写者在之前的邮箱问题中输入了 jane@example.com(存储为 email 变量),实际请求将发送到 https://api.example.com/users/jane@example.com

请求头

JSON 格式的请求头对象。同样支持变量插值。

示例

json
{
  "Authorization": "Bearer {api_token}",
  "Content-Type": "application/json"
}

请求体

对于 POST 和 PUT 请求,提供 JSON 请求体模板。支持变量插值。

示例

json
{
  "name": "{full_name}",
  "email": "{email}",
  "source": "nueform"
}

响应处理

存储响应

设置 响应变量 字段,将完整的 JSON 响应保存为表单变量。然后可以在后续问题中使用 {variableName} 语法引用这些数据。

示例:如果您将响应变量设为 user_data,且 API 返回 {"name": "Jane", "plan": "pro"},您可以在后续问题中引用 {user_data}

显示选项

加载文本

自定义请求进行中显示的加载消息。默认值:"Loading..."

静默模式

启用静默模式可在后台发送请求,不显示加载指示器。表单无需等待即可继续。适用于"发送后不管"的场景,例如数据分析调用或 Webhook 触发。

调试模式

启用调试模式可显示包含完整请求和响应详情的面板。在表单开发阶段非常有用——发布前请禁用此功能。

验证关卡

启用验证关卡可将数据节点用作上一个问题的验证器。如果 API 请求失败(非 2xx 响应),填写者将无法继续,并看到错误提示。

使用场景:验证优惠码、检查邮箱可用性,或根据后端验证访问码。

超时设置

配置请求超时时间(秒),默认为 10 秒。如果请求超时,将会失败并显示错误(静默模式下除外)。

示例

示例 1:验证优惠码

  1. 添加一个简短文本问题,用于输入优惠码(将答案存储为 coupon 变量)。
  2. 在其后添加一个数据节点,配置如下:
    • 方法:GET
    • URL:https://api.yoursite.com/coupons/{coupon}
    • 验证关卡:启用
    • 响应变量:coupon_data
  3. 如果优惠码无效,API 返回 404,填写者将看到错误提示。
  4. 如果有效,折扣信息将存储在 {coupon_data} 中供后续使用。

示例 2:补充用户数据

  1. 添加一个邮箱问题(将答案存储为 email 变量)。
  2. 添加数据节点:
    • 方法:GET
    • URL:https://api.yoursite.com/users/{email}
    • 静默模式:启用
    • 响应变量:user_info
  3. 后续问题可以引用 {user_info} 来预填字段或个性化体验。

示例 3:提交至 CRM

  1. 在表单末尾添加数据节点:
    • 方法:POST
    • URL:https://api.yourcrm.com/leads
    • 请求体:{"name": "{name}", "email": "{email}", "phone": "{phone}"}
    • 静默模式:启用
  2. 线索将在表单流程中直接创建到您的 CRM——无需 Webhook 延迟。

相关文档

最后更新:2026年4月6日