在Postman中使用 FineBI提供的接口获取数据

FineBI 通过各种样式如表格、图表等来呈现数据，进行统计分析。

FineBI 是 B/S 架构的纯 Java 软件。

这些数据表格或图表，用户在开发系统的时候也可以自己编程来实现，FineBI也提供了相应的接口。

在Postman中使用 FineBI提供的接口获取数据，这里举几个例子：

一、获取数据集

获取数据集get请求/v5/api/table/{tableName}/get
（1）首先在FineBI中导入数据，如下图，导入成绩信息：

（2）postman中请求

浏览器打开F12，在「Network>Headers」下，获取fine_auth_token的值。

http://localhost:37799/webroot/decision/v5/api/table/成绩/get?fine_auth_token=xxx

请求结果如下：（注：该接口只有表头数据，没有成绩数据）

二、获取表数据

获取表数据** post请求**/v5/api/tables/{tableName}/fields/page
（1）首先在FineBI中导入数据，如下图，导入成绩信息：

（2）使用postman

登录FineBi系统，浏览器打开F12，在「Network>Headers」下，获取fine_auth_token的值。如下图所示：

放在请求的queryString中，以?fine_auth_token=token的参数形式拼接到url上，

http://localhost:37799/webroot/decision/v5/api/tables/成绩/fields/page?fine_auth_token=xxx

（3）执行请求，这里会报一个错

提示：request body is missing，那就是没有body

参考官方文档，发现没有此接口的说明：数据表接口 - FineBI帮助文档 (fanruan.com)

查浏览器知，body值为：（除了tableName，其他参数可不写）

{
 "tableName": "成绩",  //必须
 "pageIndex": 1,       
 "limit": 5000, 
 "keyword": "", 
 "taskId": "f93638cac9147eaf"  
}

选择 raw和 json

结果如下：

（4）发现接口不一致

在postman中使用/api路径，发现FineBI在浏览器中使用/conf路径，如下图：

postman中使用conf的路径会报错。

以下为在FineBi在浏览器中使用conf的路径，获取的表数据：

三、常用的接口

Web页面集成 - FineBI帮助文档 (fanruan.com)

1、数据接口

注：直连接口，可在接口URL中，加一个direct即可。

例如添加分组：

• 抽取接口：/v5/api/group/add
• 直连接口：/v5/api/direct/group/add
  分类用途数据接口数据更新触发全局更新/v5/api/conf/update/generate触发单表/业务包更新/v5/api/conf/update/pack/table批量更新/v5/api/conf/update/batch获取此次更新实例的信息/v5/api/conf/update/instance/{taskInstanceId}数据表添加表/v5/api/table/add修改表转义名/v5/api/tables/{tableName}/rename分页获取表数据/v5/api/tables/data/page获取数据集/v5/api/table/{tableName}/get删除表/v5/api/table/{tableName}/delete获取表数据/v5/api/tables/{tableName}/fields/page编辑保存数据集/v5/api/table/update
  添加只有选字段步骤的自助数据集
  /v5/api/analysis/table/add获取自助数据集的查询SQL/v5/api/direct/analysis/table/execute/sql/{tableName}业务包添加业务包/v5/api/pack/{groupId}/add重命名业务包/v5/api/pack/{packId}/rename删除业务包/v5/api/pack/{packId}/delete获取业务包信息/v5/api/pack/{packId}/get获取业务包中的表信息/v5/api/conf/packs/{packId}分组添加分组/v5/api/group/add重命名分组/v5/api/group/{groupId}/rename删除分组/v5/api/group/{groupId}/delete获取分组信息/v5/api/group/{groupId}/get获取所有分组业务包信息
  /v5/api/conf/groups

2、仪表板接口

分类用途接口仪表板编辑新建仪表板/v5/api/platform/dashboard/reports删除仪表板/v5/api/platform/dashboard/report重命名仪表板/v5/api/platform/dashboard/rename仪表板另存为/v5/api/platform/dashboard/saveas创建公共链接/v5/api/platform/dashboard/{reportId}/create仪表板查看打开仪表板/v5/api/dashboard/report/{reportId}/view仪表板导出Excel/v5/api/dashboard/report/export/excel仪表板导出PDF/v5/api/dashboard/report/export/pdf仪表板导出图片/v5/api/dashboard/report/export/png仪表板分享取消分享/v5/api/dashboard/share/user/rejection/result分享仪表板给其他用户/v5/api/dashboard/share/user/result分享给我的所有仪表板/v5/api/dashboard/share仪表板分享给哪些用户/v5/api/dashboard/share/user仪表板信息获取用户信息和用户创建的仪表板/v5/api/dashboard/user/info仪表板管理节点所有仪表板信息/v5/api/dashboard/search获取目录下仪表板和目录列表/v5/api/platform/dashboard/list获取仪表板信息/v5/api/platform/dashboard/reports/info获取仪表板组件数据/v5/api/dashboard/report/widget/data模板血缘分析/v5/api/dashboard/report/consanguinity

3、集成接口

分类用途接口页面集成接口仪表板列表页面/dashboard仪表板编辑页面/v5/design/report/{reportId}/edit仪表板预览页面/v5/design/report/{reportId}/view数据准备页面/v5/api/conf/page数据集预览页面/v5/api/conf/page#config/{tableName}自助数据集编辑页面/v5/conf/analysis/page