文/陈淋文 刘泽欣 刘明菲
编辑/杜逸敏
集成中心自上线以来,即装即用的操作方式替代了在工作流中自行配置API请求的传统做法,大大降低了多接口的对接门槛和工作量。不过,目前不少用户还不知道安装API后如何使用、如何配置接口查询。所以,本文将以两个例子来拆解从安装连接、接口配置到最终使用的全过程。
一、场景列举
1. 爱设计模板搜索API
获取并回填接口认证信息
在使用明道云集成中心的爱设计之前,需要先在爱设计官网注册账号并且申请接口接入。
从爱设计团队获取到api-key和app-secret后(一般在账号后台就会有),填写到明道云集成中心里的api-key参数值和app-secret参数值并保存。
根据接口查询的输出内容构建工作表
先选择“API查询”控件,然后选择使用“模板搜索”。
因为接口的效果是搜索,所以可以考虑将显示方式选择为“搜索下拉框”。这样用户选中搜索结果后,系统就能将详细结果回填到表单里。
接下来就是明确输入参数。显然,搜索接口的输入参数必然会有搜索关键词,所以可以设置搜索内容作为接口输入参数搜索关键词。
配置好搜索关键词这个输入参数后,其他的输入参数就可以根据自身需求设置。设置后会对搜索进行细分,类似浏览器的高级搜索,所以不设置也没有关系。
搞定了输入参数后,就只剩下输出参数,可以先点击“将返回数据写入表单字段”,观察下输出结果的样式。比如,输出结果里有子表图标的结果,那就说明输出结果里会有多条明细记录。如果明细记录里有“更新日期”、“模板尺寸”这样的日期、文本字段,那么我们可以构建一个子表,里面放置日期和文本字段,对号入座来承载输出结果。
当我们完成字段的构建后,就可以做最后一个步骤:将输出结果对号入座到构建好的字段里。首先是搜索下拉框的内容,实际就是设置下拉列表中要显示哪些附加字段,依次点击“选项列表”、“选项名”、“附加信息”对号入座即可。
点击“将返回数据写入表单字段”,将参数名和表单字段一一映射匹配,就大功告成了。
测试集成结果
以“电商”为模板关键词获取爱设计上电商类模板的数据,最终效果如下图所示。
2. 天眼查企业基础工商信息同步
获取并回填接口认证信息
在集成中心安装天眼查后,先在天眼查官网申请接口接入,获取token。
根据接口查询的输出内容构建工作表
在工作表中使用接口查询,选择调用的API,通过设置查看该API的输出内容。
比如,调用企业联系方式的API里输出结果有电话、邮箱、地址等文本字段,也有全部电话这样的子表字段。所以,我们需要在工作表中对照输出结果,构建相应的电话、邮箱、注册地址字段来承载接口查询的输出结果。并且,将输入参数设定为工商注册名,这样员工通过搜索公司简称确定工商注册名后,就可以一键回填公司的电话、邮箱、注册地址等信息。
测试集成结果
搜索公司工商名称和回填联系信息回填效果如下动图所示。
二、总结
集成中心API的配置大体可以分为三个步骤:
- 检查接口连接的密钥key、token这些验证信息是否齐全。如果不齐全那么就要去补全,比如去官网注册账号申请接口来获取回填这些验证信息。
- 观察接口的功能描述,大致了解这个接口要传入什么数据,返回什么结果。可以先点击看下接口的输出结果都有哪些,再去根据这些输出结果搭建表单字段来承载。
- 对号入座,把输入参数的来源设置为录入的数据,输出的结果配置填入到构建的表单字段中。
集成中心现在已上线近50个第三方API连接,涵盖地图、工商、外呼、电子签、人工智能(ChatGPT)等多个领域,可根据业务场景需求安装、配置、使用。如果你有想要加入到集成中心的第三方应用,可以在零代码社区分享出来,欢迎大家一起来丰富集成中心的应用生态。