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