1. 概述
1.1 应用场景
企业安全规范要求，不允许直连业务库，代码开发接口效率低，人工传输易出错。
缺乏安全的数据共享机制，随着数据消费端增加，IT 出现重复造轮子的倾向。
1.2 功能简介
数据服务提供数据共享能力，可以将加工、融合后的数据封装发布为规范化 API 接口数据，供外部系统调用，实现数据价值输出及共享开放。
2. 约束限制
当前仅支持FineDataLink独立部署版本使用。
FineDataLink 数据服务支持的数据源详情参见：数据服务支持的数据源
注：推荐使用谷歌和 Edge 浏览器最新版本，其他浏览器可能会有兼容问题。
3. 前提条件
4. 操作流程
4.1 发布 API 流程
使用 FineDataLink 数据服务进行 API 发布的操作流程如下：
注：数据服务完整示例请参见：数据服务示例
| 步骤 |
|---|
步骤一：配置数据源 1）数据服务支持的数据源详情参见：数据服务支持的数据源 2）在进行数据服务新建 API 之前，需要将已处理好、需要发布数据对应的数据库接入 FineDataLink，以便在 API 发布配置过程中，可通过选择数据源名称来控制需要发布的数据。详情参见：配置数据连接 |
步骤二：发布API 在 FDL 中发布一个 API 需要三步，分别为：填写 API 信息、设置发布内容及参数、预览测试。详情请参见：发布 API 概述 知识扩展： 用户可发布包含参数的 API 接口，示例如下： |
步骤三：绑定 API 至应用 API 发布后，需要将 API 绑定在「应用」中，以此获取外部系统调用需要输入的鉴权认证，保证发布的 API 接口在被外部系统调用时更安全。详情请参见：绑定API至应用 「步骤二：发布API」中也可以绑定应用 该步骤中，可以：
|
步骤四（选做）：摘要签名认证、配置黑白名单 1）数据服务支持使用简单身份认证及加密身份认证调用数据服务 API，可根据需要选择。详情请参见：摘要签名认证方式 2）外部系统调用时开通黑白名单，可保证发布的 API 接口在被外部系统调用时更安全。详情请参见：配置API黑白名单 |
其他说明： 对 API 进行任务管理、监控，查看运行状态和 API 调用情况、批量上下线 API 等，请参见：服务运维 注1：4.1.6.3 及之后版本，API任务、数据服务应用禁止被多人同时编辑。详情请参见：任务禁止被多人同时编辑 注2：4.1.9.3 及之后的版本支持使用「回收站」进删除任务的还原、管理，详情请参见：回收站 注3：4.2.0.3 及之后版本，支持指定排序字段。详情请参见：发布API概述 |
4.2 调用已发布的 API 流程
| 步骤 |
|---|
步骤一：获得 API 相关信息 调用者需要获取待调用 API 的完整路径地址、参数、认证等信息 有以下两种方案：
|
| 步骤二：调用 API 可调用 API 具体说明请参见： |
5. 兼容说明
1）4.0.24 及之前的版本升级 4.0.28 版本：
对于 API 发布方，需要重新创建一遍已有 API，或是通过我们的定制脚本完成迁移。
对于调用方，在调用时由于增加了应用ID路径，需要手动修改API的访问地址。
升级前若 API 设置了参数，会自动将参数值拼接上单引号发送，更新后，所见即所传，不会自动拼接单引号过去，可能会需要调整发布SQL或者传参方式。
2）4.0.26 及之后的版本升级 4.0.28 版本：
对于调用方，在调用时由于增加了应用ID路径，需要手动修改API的访问地址。
升级前若 API 设置了参数，会自动将参数值拼接上单引号发送，更新后，所见即所传，不会自动拼接单引号过去，可能会需要调整发布SQL或者传参方式。
如有需要可联系帆软技术支持，联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。
6. 注意事项
若用户使用 FineDataLink 数据服务发布的 API 由于跨域问题无法调用，可以修改 FineDataLink 服务器目录 %tomcat%.../conf/web.xml，删除OPTIONS的配置，如下图所示：
然后重启工程。
注：此操作有一定的安全风险。
7. API输出与数据服务的区别
| 区别项 | API输出 | 数据服务 |
|---|---|---|
| 功能说明 |
「API输出」算子，可调用业务系统的接口，修改业务系统的数据 可参考示例进行理解：活动日程信息更新至企业微信日程、新增/修改宜搭表单数据 | 将处理后的数据，封装发布为规范化的 API 接口，供外部系统调用 数据服务生成的是一个API接口，可供外部系统调用 可参考示例进行理解：数据服务示例 |
