反馈已提交

网络繁忙

API输出典型示例

  • 文档创建者:Roxy
  • 历史版本:14
  • 最近更新:Roxy 于 2023-12-20
  • 1. 概述

    API输出逻辑说明 已经介绍了API输出的基本功能,用户需要将多应用系统的数据通过FDL打通,实现业务系统间的数据交互(交互的形式为API),就可以通过 API 写入满足应用集成场景。

    本文以一个具体示例为你做介绍,将数据表中的用户数据生成 JSON 格式后,通过 API 输出对接业务系统,将数据推送写入业务系统接口中,触发业务系统流转任务,实现数据交互。

    操作流程:

    2. 操作步骤

    示例数据:dw_comment.xls

    2.1 取出数据

    使用「数据转换」节点,进入编辑界面后,拖入「DB表输入」算子,SQL 语句取出需要进行 API 输出的数据,如下图所示:

    点击预览数据,如下图所示:

    2.2 生成JSON格式数据

    由于需要API写入的接口数据需要 JSON 格式,所以需要将原先的数据库表形式数据转换成 JSON 格式。

    JSON 样式如下:

    {
    "fields": {
    "summary": "文档很赞",
    "components": {
    "name": [
    "FR10"
    ]
    },
    "customfield_14904": "https://help.fanruan.com/finereport10.0/doc-view-2463.html",
    "description": "根据参数动态显示地图区域"
    }
    }

    新增 JSON 生成算子,设置输出 JSON 字段名,并进行 JSON 配置。JSON配置详情参见:JSON生成

    JSON 嵌套可以使用「子对象」和「子数组」实现,然后选择对应的字段值,如下图所示:

    同时可以修改字段类型,如下图所示:

    最终 JSON 生成设置效果如下图所示:

    2.3 进行API 输出

    新增「API 输出」算子,设置需要将 JSON 写入的 API 配置,body 中可以选择 JSON 格式,并将 JSON 作为 body,如下图所示:

    若 API 输出后的接口返回值需要继续使用,可以在返回值处理中勾选「返回响应值至参数」将返回值设置为参数,供后续使用。

    设置参数名称并添加默认值便于进行调试。

    比如示例接口如果执行成功,会返回{"code":200,"message":"success","self":"http://project.fanruan.com:6023/dataway/service/rest/api/2/issue/804566"}

    将其设置为参数,如下图所示:

    可在后续节点调用该参数,如下图所示:

    • API输出执行状态与 HTTP 响应状态绑定:运行时和预览时只有当响应状态码为2xx时,执行成功,否则报错,错误信息内包含具体的状态码和响应body信息。

    • 「返回响应值至参数」选项为复选框,默认不勾选,勾选后用户可以设定参数名与默认值,其中默认值为用户自行从API接口文档内复制粘贴的多行文本。

    2.4 运行任务并查看效果

    保存并运行任务,任务执行成功后,会通过API输出推送数据至业务系统中,例如生成任务,如下图所示:

    企业微信截图_16776535206288.png

    3. 注意事项

    API输出支持关闭SSL证书验证:

    当 API 使用了https 可以取消证书有效性验证,用户在Headers内新增一个参数、参数名为SSL-certificate-verification,当客户配置此参数时:

    当SSL-certificate-verification值为false时,FDL在调用API不进行证书有效性验证(当然仅当目标端的API配置了https时,才需要进行证书有效性验证)

    注:在实际传给服务端的API的Headers内去除此参数,此参数仅应用于FDL内部;

    附件列表


    主题: 数据开发
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持