1. 概述编辑
1.1 版本
| FineDataLink版本 | 功能变动 |
|---|---|
| 4.0.20.1 | - |
| 4.0.26 | 非超级管理员支持使用数据服务 |
| 4.0.27 | 支持使用 FineBI 公共数据作为数据来源 |
| 4.0.28 | 数据发布API 支持设置 SQL防注入，以便使用 IN 语法实现多值查询 数据发布API参数支持传入NULL值 数据发布API参数支持配置必填 / 非必填 数据发布API支持GET请求方式 数据发布API的POST请求方式，额外支持x-www-form-urlencoded格式 |
1.2 应用场景
用户需要把上游数据采集、加工好以后，存到指定数据库，希望将这些数据封装成 API 接口，供下游系统调用。
开发API时，用户需要使用 SQL 的 IN 语句一个参数传入多值，对指定表的指定列做多值查询。
2. 操作步骤编辑
示例需要将 S订单中数据发布为 API，并在取数时可同时取出多个地区（华北、华东、华南等等）的数据。
2.1 新建API
进入「数据服务」，点击「新建>API」，进入API 发布编辑界面，如下图所示：
2.2 输入API信息
设置 API名称、可对API进行描述说明，同时设置发布的API 的路径，并选择是否开启认证，最后设置超时时间，如下图所示：
API的请求路径、请求格式、返回格式等基本信息详情参见：发布API
2.3 设置发布内容及参数
选择要发布的数据源以及数据连接，然后输入查询 SQL 语句，如下图所示：
SELECT * FROM S订单 WHERE 货主地区 IN ('${货主地区}')
该参数在 API发布后，可在通过 API 取数时使用 SQL 语句设置的参数进行条件取数。
注：为了解决 SQL 防注入问题，SQL语句参数不允许加引号，从数据库工具复制过来的 SQL 需要手动删除参数引号，在查询预览的时候手动给参数默认值加引号进行预览。若用户想要在 SQL 语句中加引号，则可以在SQL 防注入 中将转义字符引号取消选择。
请求参数配置中会自动识别查询 SQL 设置的参数名，可以定义该参数的参数类型，勾选「参数必填」并进行描述，如下图所示：
参数必填即当前参数不能为空。
点击查询预览，输入预览参数值，点击「预览」，如下图所示：
即可看到满足条件的预览结果，如下图所示：
2.4 预览测试
点击下一步进入「预览测试」界面。
点击「测试API调用」，输入请求参数值，补充 body 内容进行测试，即可看到测试接口返回结果，如下图所示：
点击「生成API」即可完成API生成，如下图所示：
2.5 API上线
API列表展示所有API信息，选择指定的API ，可查看基本信息和API 的内容以及参数。
在右上角点击「上线」，即可发布 API，如下图所示：
