一、功能简介
您可以使用外部请求动作去调用第三方的接口,并根据实际接口的响应来帮助您收集数据或者执行后续自动化流程。
例如:
- 通过外部请求,给请求URL发送访客数据(用户名、手机号、邮箱、访客最后发送消息),来满足第三方平台的数据收集和分析目的。
- 通过外部请求,返回特定的数据并生成相应变量,该变量可在发送消息动作中使用,来满足特定的自动化回复需求。
什么是API接口?
API(Application Programming Interface,应用程序编程接口)是应用程序重要的组成部分,接口是一种允许不同软件应用程序之间相互通信和交换数据的工具,就是应用程序对外提供了一个操作数据的入口,这个入口可以是一个函数或类方法,也可以是一个url地址或者一个网络地址。当客户端调用这个入口,应用程序则会执行对应代码操作,给客户端完成相对应的功能。
HTTP请求方法:
HTTP方法指的是客户端与服务器之间进行通信时所使用的标准HTTP协议中定义的方法。这些方法定义了客户端对服务器资源的操作方式,从而决定了对应API接口的行为。常见的方法包括:
- GET:用于请求服务器返回特定资源的表示形式,通常用于获取数据,GET方法不会对服务器资源产生影响,是安全且幂等的
假设你在使用一个新闻阅读应用,你想要查看今天的新闻头条。当你打开应用并点击“查看新闻”按钮时,应用会向服务器发送一个GET请求,请求今天的新闻数据。服务器接收到这个GET请求后,会返回包含今天新闻头条的数据,以便你在应用中查看。
-
POST:用于向服务器提交数据,常用于创建新资源或执行非幂等的操作。POST请求可能会改变服务器的状态或产生副作用
现在假设你在同样的新闻阅读应用中,你想要发布一条评论。当你在阅读某篇新闻时,在评论框中输入你的评论后,点击“发布评论”按钮,应用会向服务器发送一个POST请求,将你的评论内容发送到服务器。服务器接收到这个POST请求后,会将你的评论保存到数据库中,并返回一个表示评论成功发布的响应
-
PUT:用于向服务器更新或替换资源,通常用于完全替换指定资源或创建新资源,但需要客户端提供完整的资源表示形式。PUT请求应该是幂等的,即多次调用相同的PUT请求结果应该是一致的
当你编辑个人资料时,可能会使用PUT方法。例如,你在社交媒体平台上更新了个人资料信息(如姓名、生日、头像等),当你点击“保存”按钮时,客户端会向服务器发送一个PUT请求,将更新后的个人资料发送到服务器,服务器将使用这些信息更新你的个人资料。
-
DELETE:用于请求服务器删除指定的资源,常用于删除指定的资源。DELETE请求应该是幂等的,即多次调用相同的DELETE请求结果应该是一致的。
当你在社交媒体平台上删除一条发帖时,可能会使用DELETE方法。当你点击“删除”按钮时,客户端会向服务器发送一个DELETE请求,请求删除指定的帖子,服务器将删除该帖子及其相关内容。
二、操作流程
1.添加外部请求动作
点击右侧+号>点击外部请求动作>完成添加。
2.配置外部请求
2.1 配置请求URL(必填)
- 点击外部请求打开配置窗口>选择请求方法(POST、GET、DELETE)>根据需要,填写请求URL。
- 根据需要,可支持带上用户数据,调用请求URL。点击+号>点击所需传输数据>完成添加。(选填)
2.2 填写请求URL所需参数Headers、Body(根据需要,选填)
- 根据请求URL的需要,添加Headers或Body。点击添加>填写即可。
- 同样,可添加用户的数据。点击+号>根据需要,选择相应用户的数据。
2.3 测试请求
您可以测试刚刚填写好的内容,查看是否调用成功或者回调的数据。
- 点击测试请求,即可开始测试。
- 若数据返回的数据不正常,可修改数据后,点击重新请求,进行重新测试。
2.4 使用Response 映射
- 您可以使用外部响应回来的内容,将其指定为对应变量,并在发送消息动作中使用。
- 点击添加>按需求,输入响应回来的内容(需按Json路径格式填写)>根据后面展示的对应变量,在发送消息中填入相应变量,即可触发后续自动化发送特定变量消息。
注:Json路径格式可参考https://goessner.net/articles/JsonPath/,其中有样例介绍,如图二。
常见问题:
1.能否拿到整个data的数据?
不能,只能拿到data下面的其中的某一项
2.自动化流程这里的根据外部请求的返回值,可以根据{{FIELD_0}} 返回值判断分支吗?
暂时不支持,目前外部请求的返回值仅支持发送消息