开放平台API接口调用示例
本Demo示例展示:免预览提交数据,提升填报效率
需用到的接口实例是:[demo]填报服务
示例一:单行数据填报6.1.1 配置过程参考2.1、2.2节,SQL数据服务的配置过程
API管理:
1)在API管理的基础数据接口中,点击[demo]填报服务的编辑按钮,进行API信息的配置
2)在基础页面,信息已默认配置好,无需任何操作;此处只需记下API路径和API方法两个参数,用于后续步骤中,API调用时的链接填写
3)在配置页面,有1个配置项,
report:数据来源的报表路径(相对于reportlets)
在这个示例中,我们的配置为:
report = 填报示例(单行).cpt
模板下载:
填报示例(单行).cpt
模板中写入a、b、c、d4个参数
应用管理:
在应用管理中,记下“测试”应用的应用ID和密钥两个参数,用于后续步骤中,API调用时的鉴权
权限管理:
在权限管理中,选定应用为“测试”;开启基础数据接口分组中,[demo]填报服务。以保证该API可用
6.1.2 效果预览链接为:http://localhost:8075/webroot/decision/sp/client/api/write/report/data。
group/report/data和GET分别为API路径和API方法;将应用ID和密钥写入Headers中。
在Params中,给a、b、c、d4个参数赋值。
可以看到数据表中增加了1条填报的数据
示例二:多行数据填报本示例配合数据工厂数据集插件进行展示,数据工厂数据集插件见:数据工厂数据集
数据工厂数据集插件的作用:可以按照要求的格式写入数据,一次性填报大量内容;减少传统的在前端页面表格中,逐行进行填报的工作量
6.2.1 配置过程参考2.1、2.2节,SQL数据服务的配置过程
API管理:
1)在API管理的基础数据接口中,点击[demo]填报服务的编辑按钮,进行API信息的配置
2)在基础页面,信息已默认配置好,无需任何操作;此处只需记下API路径和API方法两个参数,用于后续步骤中,API调用时的链接填写
3)在配置页面,有1个配置项,
report:数据来源的报表路径(相对于reportlets)
在这个示例中,我们的配置为:
report = 填报示例.cpt
模板下载:
填报示例.cpt
应用管理:
在应用管理中,记下“测试”应用的应用ID和密钥两个参数,用于后续步骤中,API调用时的鉴权
权限管理:
在权限管理中,选定应用为“测试”;开启基础数据接口分组中,[demo]填报服务。以保证该API可用
6.2.2 效果预览链接为:http://localhost:8075/webroot/decision/sp/client/api/write/report/data。
group/report/data和GET分别为API路径和API方法;将应用ID和密钥写入Headers中。
在Body中按格式要求,写入需要填报的内容。
可以看到数据表中增加了2条填报的数据
本示例中数据工厂配置的信息如下图:
其中,装载方式为单参数,参数填写为${body},右侧参数body自动填充。此处对应postman中的请求体Body,即传入的参数为body;
参数值按照数据库表中的格式填写即可,在postman的请求体Body中,写入的需要填报的内容,也遵循该格式;
解析方式为json,即将需要填报的内容,通过数据工厂,转化成json格式。此处可根据实际需求,选择对应的解析方式。