API 配置中的 body 请求内容支持使用 Content-Type 为 form-data 和 x-www-form-urlencoded 请求格式,可以添加多行,每行选择一个字段,使用字段名作为键名、使用字段值作为键值,详情参见本文第四节。
用户需要将多应用系统的数据通过FDL打通,实现业务系统间的数据交互(交互的形式为API)。
比如系统中数据取出并分析后,希望直接把分析结果数据推送到业务系统中(以 API 的形式),形成业务系统里面需要直接处理的业务数据,打通分析到业务的流程。
或者希望实现简道云数据下云后将数据推送至指定API接口。
FineDataLink 支持 API 输出,通过 API 写入满足应用集成场景。
如果 API body 中的请求格式为 raw,前置节点的字段数据行数仅支持一行。可能需要使用循环容器来确保生成的JSON 或者 XML 数据能作为参数一条条接入 API 。详情参见:API输出最佳实践
API输出只支持 POST、PUT、DELETE 三种请求方式。注:GET方法不需要前置输入字段,如果需要可以使用输入算子去实现。
Headers 请求头中的Content-Type
支持 application/x-www-form-urlencoded、application/json、application/xml、multipart/form-data、text/xml、text/plain 请求格式;
允许用户在 Headers 内对 Content-Type 进行自定义设置,即 Content-Type 的下拉框支持输入非下拉列表值;
Body与Content-Type双向联动
如果输入的 Content-Type 不在联动列表内,则 Body 内格式较改变 Content-Type 前不发生变化;
如果用户输入不在列表内的 Content-Type 后,再修改Body的格式,则自动覆盖Headers内的Content-Type为联动值;
API输出执行状态与 HTTP 响应状态绑定:
运行时和预览时只有当响应状态码为2xx时,执行成功,否则报错,错误信息内包含具体的状态码和响应body信息,具体见本文第六节。
「返回响应值至参数」选项为复选框,默认不勾选,勾选后用户可以设定参数名与默认值,其中默认值为用户自行从API接口文档内复制粘贴的多行文本。
API输出支持关闭SSL证书验证:
支持用户在Headers内新增一个参数、参数名为SSL-certificate-verification,当客户配置此参数时:
当SSL-certificate-verification值为false时,FDL在调用API不进行证书有效性验证(当然仅当目标端的API配置了https时,才需要进行证书有效性验证)
注:在实际传给服务端的API的Headers内去除此参数,此参数仅应用于FDL内部;
1)使用算子或者节点取出需要进行 API 输出的数据。
2)根据需要API写入的接口数据格式,使用数据开发算子或者节点进行数据处理,如果写入接口数据为 JSON 格式,可以使用 JSON生成 将数据生成为 JSON 格式。
3)进行 API 输出设置,选择需要输出API的请求方式并输入API URL ,设置 Query 参数、认证方式和请求头等。
然后根据接口设置 Body 传参样式,将前置算子或者节点处理好的字段作为API body 中的参数,如下图所示:
4)处理 API 返回值。
任务构建失败
异常节点:【数据转换】
[API输出]: 源字段为空
[API输出]:未接入前置节点
[API输出]:JSON格式非法
[API输出]:XML格式非法
[数据转换] - 执行失败
[API输出]:API连接超时 - (后端报错信息)
[API输出]:API连接响应错误 - API响应错误(API响应状态码、API响应body(前10行)、后端报错信息及堆栈)
推荐API输出典型应用场景:API输出典型示例
滑鼠選中內容,快速回饋問題
滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。
不再提示
10s後關閉
Submitted successfully
Network busy