发送网络请求

“发送网络请求”提供了一种强大的自动化机制，允许用户通过构建网络请求，实现与第三方平台间的数据交换。这不仅增强了系统的互操作性，也极大地扩展了数据处理和集成的可能性。

此“动作”支持多种网络请求方法，包括 GET、POST、PATCH 和 DELETE。你可以根据自己的需求选择合适的方法来访问第三方 API，以实现数据的读取、更新、添加或删除。

快速入门/配置说明

要开始利用“发送网络请求”，你需要配置若干关键参数以定义你的请求。界面上提供的配置项及其说明如下：

• 请求方法（HTTP request methods）: 根据你想要交互的外部 API，选择一个合适的 HTTP 请求方法。选项包括：

  • GET：常用于拉取数据。
  • POST：常用于发送新的数据。
  • PATCH：常用于更新现有的数据片段。
  • DELETE：常用于删除数据。

• 请求地址: 填写你希望发送请求的 API 端点地址（Endpoint），通常以 "https://" 或 "http://" 开始。

• 请求头（HTTP headers）: （可选）指定请求所需的头部信息。这些信息通常用于提供认证信息、指定请求的内容类型等。例如，如果 API 需要认证，你可能需要添加一个名为 Authorization 的头部，并将其值设置为 Bearer <token>，其中 <token> 是你从第三方服务获取的实际令牌。例如，维格云的 API 就需要使用 Bearer Token 进行认证，详细信息请参见开发者文档。

• 请求体（HTTP body）: （可选）对于 POST、PATCH 等方法，你可以在请求体中发送数据。

  • 如果请求方法是 GET，则请求体留空即可。
  • 请求体类型包含 json, form-data, 或 raw 三种，这将决定请求头是否需要添加 Content-Type 及请求体数据该用什么数据结构。
    • json: 是现代 Web 网站最常用的数据交换格式，以键值对形式进行数据编排。
    • form-data: 也是一种数据交换格式，常见于各类表单网页的数据提交，此处不展开，有兴趣的请在搜索引擎检索“form data”
    • raw: 如果第三方服务提供的API需要特殊的数据交换格式，请选择此项。

示例

通过动作“发送网络请求”，维格云可以调用第三方平台的API，从而实现两个平台之间的数据交换。本文准备了两个例子，帮助你理解“发送网络请求”是如何工作的。

1. 自动化配合按钮列，实现一键创建订单

假设场景是客户管理与订单跟踪。我们提前已创建好两个维格表：

• A表：客户管理表，保存客户信息。
• B表：订单跟踪表，保存客户的订单数据。

通过“自动化”能力，我们可以实现：

• 当在客户表中新增一个客户时，自动在订单表中创建一个新的订单记录，并与对应的客户关联。
• 当老客户追加订单时，销售人员依然可以在客户表点击按钮列的“创建订单”按钮，给该客户在订单表中追加一个新订单的记录。

以下是操作流程的示意图：

按照上方所述，完成表格和自动化任务的搭建后，以下是操作效果的展示：

上方效果图里，预置了三个示例客户“极光玩具有限公司”，“晨光贸易”，“乐盈盈玩具有限公司”。当销售人员点击表格里的“创建新订单”按钮，系统就会触发自动化任务“自动创建订单”，从而为该客户在“订单跟踪表”里创建一条以 日期 加 自增数字 构成订单编号的订单记录，并且实现两表的记录 双向关联。

本示例着重讲解“发送网络请求”部分的知识，关于 按钮 和 自动化 的功能说明，请提前自行学习。

自动化任务“自动创建订单”的详细配置如下:

要理解截图中的配置详情，你首先需要熟悉维格云提供的 API。本例中，我们使用了“创建记录” API。

• ① 选择 POST 作为“请求方法”，表示本次操作旨在创建新记录。

• ② “请求地址”填写 创建记录 的 API 请求地址，URL地址需要带上“订单跟踪表”的 datasheetId（什么是 datasheetId?）。

• ③ 在“请求头”中添加认证信息，键名为 Authorization, 值为 Bearer {你的个人API token}（注意"Bearer"末尾带有一个空格），API Token的获取方式请点击这里。

• ④ 在“请求体”中，类型选择 json，然后请求体的内容如下方示意图。请求体内容是根据维格云 “创建记录” API要求而填写的 JSON 数据，详细说明请看开发者文档 。

  

  为了便于讲解，请求体内容做了简化，仅仅在“订单跟踪表”里新增了一条记录，并且在“客户”字段里插入相应客户在“客户管理表”的 recordId（什么是 recordId?）。这样，当销售人员点击“创建新订单”按钮后，就可以实现创建订单，并将客户和他的订单进行双向关联。

  请求体中的字段必须与表结构相对应。在此示例中，使用的字段是 客户 ，完整的 JSON 请求体为：

  {
    "records": [
      {
        "fields": {
          "客户": "{此处请插入变量}",
        }
      }
    ],
    "fieldKey": "name"
  }

2. 通过第三方连接器将数据推送至各类平台

在例子1中，“发送网络请求”实现了维格云内部的数据流转，A表的数据变化会让B表也自动更新。而例子2的示意图，讲述的是通过动作“发送网络请求”，实现将维格表里的一行数据（记录）推送至第三方的连接器平台，再通过它们丰富的应用集成，实现与多种多样的平台的数据连接。

以下是使用连接器平台 Webhook 功能接收维格云数据的效果图：

腾讯云Hiflow，集简云，数环通这些连接器平台，都具备 Webhook 的能力。使用 Webhook，连接器平台可以接收来自外部系统的数据，在示意图中描述的是接收来自维格表的客户数据。维格表的自动化动作“发送网络请求”配合第三方连接器平台的 Webhook 能力，具有非常丰富的应用场景，例如：

• 客户关系管理（CRM）同步：将销售和客户服务数据从维格云自动同步到第三方CRM平台，如Salesforce或HubSpot，以便销售团队可以实时访问最新的客户互动记录和销售机会。

• 电子商务订单处理：自动将维格云中记录的新订单推送到电子商务平台（如Shopify或Magento），并同步库存信息，以实现订单处理和库存管理的自动化。

• 财务软件集成：将维格云中的财务数据（如发票和支出记录）发送到第三方财务软件，自动更新账目，简化会计流程。

• 项目管理工具同步：自动将任务和项目更新从维格云推送到项目管理工具（如Trello或Asana），使团队成员能够跨平台协作，实时跟踪项目进度。

• 市场营销自动化：将维格云中的客户数据和交互记录发送到市场营销自动化平台（如Mailchimp或Marketo），用于触发个性化的营销活动和电子邮件序列。

• 社交媒体管理：自动将维格云中的营销内容推送到社交媒体管理工具（如Hootsuite或Buffer），实现社交媒体平台上的内容发布和管理自动化。

（以上场景仅供参考和灵感启发，具体解决方案仍需你打磨和逐步完善）

常见问题

为什么发送网络请求会失败？

• 检查请求参数：确保请求方法、请求地址、请求头和请求体内容准确无误。你可以使用 Postman 这样的工具复制请求并验证其有效性。
• 检查响应：查看执行历史记录中的任何错误信息。错误通常会记录在运行历史中。有关故障排除步骤，请访问：https://help.vika.cn/docs/guide/manual-automation-robot#how-to-troubleshoot。

选择不同请求体类型将使用什么样的 Content-Type？

• JSON：当请求体内容为 JSON 对象时，使用 application/json（选填，系统会自动补充）。
• Form-Data：对于简单的键值对，使用 application/x-www-form-urlencoded。
• Raw：对于原始文本，使用 text/plain。使用原始文本时，请确保你的 API 端点能够解析你发送的文本格式。

请注意头部中的 Content-Type 需要与输入的请求体相匹配。

相关术语参考

为了帮助不熟悉编程的用户理解以上内容，以下是一些有用的第三方知识库链接：

• 什么是 Http 请求方法
• HTTP 认证/Authorization
• 什么是 JSON