跳到主要内容

API查询控件介绍


功能概述

在创建记录或编辑记录时,可以通过此控件调用外部API接口获取数据,并将获取到的数据直接填充到当前记录的字段或子表中。除了获取数据,也支持向外推送数据。

应用场景举例

  • 添加客户信息时,根据客户公司名称从天眼查平台搜索相关工商信息并填充到相关字段。

  • 根据物流单号,获取到物流信息后,自动填充到物流信息子表中。

  • 下拉列表数据源,来自于外部系统。

配置示例

获取单行数据配置示例

场景:根据手机号获取归属地后,将数据写入到对应的省份、城市字段中。

1、添加API查询字段

2、选择API接口

  • 只能选择被授权过的API

3、配置参数

系统会根据API配置,自动显示需要的参数。所以,这里的参数不是固定的,不同API可能不同,名称有红星的为必填参数,没有红星的可以选填。

4、选择字段显示类型

类型有三种:按钮、下拉框、搜索下拉框,区别如下;

  • 按钮: 在点击按钮时请求并获取返回参数

  • 下拉框: 在激活下拉框时请求,将返回的多条数据列表作为下拉菜单的选项进行选择

  • 搜索下拉框: 在激活下拉框时请求,将返回的多条数据列表作为下拉菜单的选项进行选择

下拉框和搜索下拉框的方式只适合用返回多条数据的场景,查询手机号归属地的API没有返回对象数组,因此本场景只能选择按钮的方式。 另外两种方式请参考多行数据配置示例。

5、将返回数据写入表单字段

配置好API、参数和类型后,就可以将返回的数据写入到对应的字段了。

效果:

字段的映射规则

API返回多行数据的配置示例

场景:输入公司名称后,去天眼查API搜索相关公司,可能会搜索到多家公司(多行数据),我们来看下如何将其他工商信息填充到对应字段中。

1、添加API查询字段

2、选择要调用的API

  • 只能选择被授权过的API

  • 选择API后,还需要配置传入的参数,名称有红星的为必填参数。

3、配置参数

系统会根据API配置,自动显示需要的参数。所以,这里的参数不是固定的,不同API可能不同。

4、选择显示类型

类型有三种:按钮、下拉框、搜索下拉框,先看三种类型的效果演示:

  • 如果是按钮方式,则查询的关键词必须选择其他字段,且获取的多条数据必须写入到子表。

  • 下拉框和搜索下拉框的方式,可以在本字段中输入搜索关键词,并将搜索到的结果显示在下拉选项中,当您选择一个后,实际已经相当于精确搜索,查询结果变为一行数据,则可以相关数据直接写入到本记录普通字段中。

5、按钮类型配置

由于是多条数据,必须写入到子表,选择一一对应的映射字段即可。

6、下拉框方式和搜索下拉框

下拉方式需要将返回的数据的某个字段作为选择项显示,供用户选择,因此需要的配置下拉框选项。

API返回参数,字段配置参数和操作效果对比如下图:

搜索下拉框的更多功能

搜索下拉框的字段映射和效果请参考下拉框方式,但是这种方式还有更多的可选功能。

搜索方式
  • 按钮搜索: 输入关键词后点击按钮才搜索并显示选项

  • 实时搜索 输入关键词后自动搜索并显示选项,这种方式可能会产生更多的API费用。

最少字数

当输入满足了最小字数后才会发起请求,当API的搜索参数有字数限制时可以设置此配置

在搜索前先进行一次请求

勾选后,在激活搜索下拉框时先进行一次请求,此时向接口传入的搜索参数为空,并将返回结果作为预设的选项以供选择。当API的搜索参数支持传空时,可以勾许此项。

输入参数

搜索下拉框可以直接把输入的搜索内容作为参数传递给API,另外两种方式必须选择其他字段值。

字段映射规则


文档问题反馈

文档中是否有错别字、内容过期、难以理解等问题? 点此给我们反馈吧