最新历史版本 :数据查询API-多值查询 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:
icon提示:
本文方案适用于 4.2.6.2 及之后版本;4.0.28 之前版本,请参见:历史文档;4.0.28-4.2.6.2 版本,请参见:历史文档

目录:

1. 概述编辑

1.1 版本

FineDataLink版本
功能变动
4.0.28
支持使用 IN 语法实现多值查询

1.2 应用场景

用户想要在发布 API 时,对 API 取数逻辑进行设置:使用 SQL 的 IN 语句一个参数传入多值,对指定表的指定列做多值查询。

2. 操作步骤编辑

示例需要将「订单表」中的数据发布为 API,并在取数时可同时取出多个地区(华北、华东、华南等)的数据。

2.1 新建API

进入「数据服务」,点击「新建>接口服务」,输入接口服务的名称后,点击「确定」按钮。如下图所示:

2.2 设置API信息

2.2.1 服务内容(数据查询)

设置界面如下图所示:

SELECT * FROM `demotest`.`订单信息` WHERE 货主地区 IN ('${货主地区}')


各设置项说明如下:

各设置项详细说明请参见:发布API概述

设置项

说明

SQL语句

示例为 MySQL 数据库语法,不同数据库的语法不同,用户可根据实际使用数据库类型修改语法

分页查询

关闭「分页查询」按钮,调用生成的 API 后返回数据不进行分页

自定义参数

为自定义参数货主地区调试值写入华东','华北,可查询「货主地区」为华东、华北的数据

2.2.2 API接口配置

1)请求方式选择 POST;路径设置为 demo(支持自定义) 。

添加应用,若此时没有创建应用,可不添加应用,在完成 API 创建后,在应用列表中绑定 API ,详情参见:绑定API至应用绑定应用步骤必做,否则后续无法调用该 API

请求 Body 格式设置为 application/json。如下图所示:

各设置项详细说明请参见:发布API概述

2)点击右下角的「测试调用」按钮,可调试 API;「货主地区」参数值默认为调试值:华东','华北,返回多值查询内容。如下图所示:

2.png

3)点击保存并上线按钮,即可成功新建并上线服务接口。如下图所示:

3. 后续步骤编辑

若用户在发布时没有将 API 添加至指定应用,也可以在 API应用管理 中将上线的 API 通过应用进行管理,以便能够被调用。

若需要使用已经发布的API,详情参见:使用发布的API,调用效果如下图所示:

对已经发布的API进行管理,详情参见:服务运维