目录:
1、概览编辑
1.1 应用场景
希望从应用的API接口获取数据,同步到数据库。
该篇案例以简道云API接口为例,获取简道云的组织架构表。若是其他应用API,需要查看其API开发手册规范。
参考文档:
① 简道云的API接口说明:部门管理 - 简道云 - 开放平台 (jiandaoyun.com)
② 简道云的API接口鉴权说明:开发指南 - 简道云 - 开放平台 (jiandaoyun.com)
1.2 配置流程
① 通过HTTP Clien算子对接简道云API接口
② 通过JSON格式化组件,对部门、上级部门、名称进行解析
③ 通过写表输出将解析后的数据写入到数据库
2、实现步骤编辑
任务配置图如下:
2.1 生成记录
由于HTTP Client组件不是输入组件类,所以需要 采用生成记录作为任务开始组件。
2.2 HTTP Client
此步的配置需要根据应用的API接口开发规范进行配置。
2.2.1 基本配置url配置
根据此篇文档:部门管理 - 简道云 - 开放平台 (jiandaoyun.com) 确认API 接口的url:
① 由于希望获取一级部门下的子部门,所以将{dept_no}设置为1
② 由于希望获得所有的子部门,而不是只有一级子部门,所以采用post请求方式,在body中进行参数填写
2.2.2 鉴权Headers配置
由于需要对应用进行鉴权,所以参考应用开发文档:开发指南 - 简道云 - 开放平台 (jiandaoyun.com)
① 在 FineTube的 Headers中进行配置,在此需要知道您的APIKEY( 需要找应用管理员进行获取 ,简道云的API KEY的获取参考此篇文档:密钥管理 - 简道云 - 开放平台 (jiandaoyun.com))
在FineTube的配置页面 的字段名 设置为:Authorization;字段值设置为 Bearer 您的APIKEY (注:Bearer 和您的APIKEY之间有一个空格)
2.2.3 预览
此时直接进行预览,即可看到接口返回的数据:
2.3 json格式化
由于返回的部门 departments 为 JSON数组模式,需要将 一个数组字段转换成多行。
2.3 表输出
① 可以选择您已经配置的数据库,进行数据表的输出,若不存在此表,可进行新建
② 在字段配置时,可自动获取全部字段后,删除无效字段,比如response_time、response_time,然后勾选 dept_no 作为输出表的业务键主键。
③ 写入设置的提交模式,设置为 插入更新即可。
3、结果查看编辑
4、暂不提供参考文件下载编辑
由于API请求中包含鉴权headers,所以此任务暂不提供任务导出。