API 定义
symbol, apiName, apiCode说明
symbol字段说明
| 符号 | 描述 |
|---|---|
NONE | 无(不进行任何条件匹配) |
LLIKE | 左模糊匹配(如 %关键词) |
RLIKE | 右模糊匹配(如 关键词%) |
LIKE | 模糊匹配(如 %关键词%) |
NOTLIKE | 不匹配(模糊) |
EQ | 等于 |
NE | 不等于 |
GE | 大于等于 |
GT | 大于 |
LE | 小于等于 |
LT | 小于 |
IN | 在列表中 |
NOTIN | 不在列表中 |
BETWEEN | 介于...之间(范围查询) |
ISNULL | 为 NULL |
NOTNULL | 不为 NULL |
JSON_CONTAINS | JSON 字段包含指定内容 |
💡 小贴士:
LLIKE/RLIKE适用于需要精确控制模糊匹配方向的场景(如搜索时关键词在开头/结尾)JSON_CONTAINS用于操作 JSON 类型字段,例如{"tags": ["java", "spring"]}中的tags字段包含spring
apiName 说明
apiName 为 查询器部署时指定的接口名称, 查询时如未指定接口编码则默认使用最新部署的配置版本。
apiCode 说明
apiCode 查询器部署时自动生成的接口编码, 查询时用于指定使用特定的配置版本。
selectPage 分页查询接口
管理后台-接口地址: /admin-api/lowcode/deploy-api/{apiName}/select-page
用户端-接口地址: /app-api/lowcode/deploy-api/{apiName}/select-page
请求方式: POST
接口描述: 根据查询配置,执行分页查询
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 |
|---|---|---|---|
apiName | 接口名称 | 路径参数 | 是 |
apiCode | 接口编码 | 查询参数 | 否 |
queryDomainParams | 请求参数 | 请求体 | 是 |
pageParams | 分页参数 | 是 | |
pageNo | 页码,从 1 开始 | 是 | |
pageSize | 每页条数 | 是 | |
sortingFields | 排序参数 | 否 | |
field | 排序字段 | 否 | |
order | asc desc | 否 | |
whereParams | 查询参数 | 否 | |
name | 查询字段名 | 是 | |
symbol | 查询符号类型 | 是 | |
value | 查询值(取决于 symbol 类型) | 取决于 symbol | |
values | 查询值数组(取决于 symbol 类型) | 取决于 symbol |
💡 使用提示
symbol的值需匹配QueryDomainSymbolType枚举(如EQ/LIKE/BETWEEN)value和values的实际值类型由symbol决定(例如BETWEEN需传入数组[min, max],IN需传入列表)
响应参数:
| 参数名称 | 参数说明 | 类型 |
|---|---|---|
code | 状态码 | Integer |
msg | 返回信息 | String |
data | 返回数据 | PageResul |
total | 数据总量 | Integer |
list | 数据列表 | List |
请求示例:
{
"pageParams": {
"pageNo": 1,
"pageSize": 10,
"sortingFields": [
{
"field": "",
"order": ""
}
]
},
"whereParams": [
{
"name": "",
"symbol": "",
"value": {},
"values": []
}
]
}响应示例:
{
"code": 0,
"msg": "",
"data": {
"total": 0,
"list": []
}
}selectOne 单条查询接口
管理后台-接口地址: /admin-api/lowcode/deploy-api/{apiName}/select-one
用户端-接口地址: /app-api/lowcode/deploy-api/{apiName}/select-one
请求方式: POST
接口描述: 根据查询配置,执行单条数据查询
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 |
|---|---|---|---|
apiName | 接口名称 | 路径参数 | 是 |
apiCode | 接口编码 | 查询参数 | 否 |
queryDomainParams | 请求参数 | 请求体 | 是 |
whereParams | 查询参数 | 否 | |
name | 查询字段名 | 是 | |
symbol | 查询符号类型 | 是 | |
value | 查询值(取决于 symbol 类型) | 取决于 symbol | |
values | 查询值数组(取决于 symbol 类型) | 取决于 symbol |
💡 使用提示
symbol的值需匹配QueryDomainSymbolType枚举(如EQ/LIKE/BETWEEN)value和values的实际值类型由symbol决定(例如BETWEEN需传入数组[min, max],IN需传入列表)- 仅返回一条数据
响应参数:
| 参数名称 | 参数说明 | 类型 |
|---|---|---|
code | 状态码 | Integer |
msg | 返回信息 | String |
data | 返回数据 | Object |
请求示例:
{
"whereParams": [
{
"name": "",
"symbol": "",
"value": {},
"values": []
}
]
}响应示例:
{
"code": 0,
"msg": "",
"data": {}
}selectList 列表查询接口
管理后台-接口地址: /admin-api/lowcode/deploy-api/{apiName}/select-list
用户端-接口地址: /app-api/lowcode/deploy-api/{apiName}/select-list
请求方式: POST
接口描述: 根据查询配置,执行列表查询(不分页)
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 |
|---|---|---|---|
apiName | 接口名称 | 路径参数 | 是 |
apiCode | 接口编码 | 查询参数 | 否 |
queryDomainParams | 请求参数 | 请求体 | 是 |
pageParams | 分页参数 | 否 | |
sortingFields | 排序参数 | 否 | |
field | 排序字段 | 否 | |
order | asc desc | 否 | |
whereParams | 查询参数 | 否 | |
name | 查询字段名 | 是 | |
symbol | 查询符号类型 | 是 | |
value | 查询值(取决于 symbol 类型) | 取决于 symbol | |
values | 查询值数组(取决于 symbol 类型) | 取决于 symbol |
💡 使用提示
symbol的值需匹配QueryDomainSymbolType枚举(如EQ/LIKE/BETWEEN)value和values的实际值类型由symbol决定(例如BETWEEN需传入数组[min, max],IN需传入列表)
返回多条数据,不超过配置的最大返回行数
响应参数:
| 参数名称 | 参数说明 | 类型 |
|---|---|---|
code | 状态码 | Integer |
msg | 返回信息 | String |
data | 返回数据列表 | Array |
请求示例:
{
"pageParams": {
"sortingFields": [
{
"field": "",
"order": ""
}
]
},
"whereParams": [
{
"name": "",
"symbol": "",
"value": {},
"values": []
}
]
}响应示例:
{
"code": 0,
"msg": "",
"data": []
}selectCount 统计查询接口
管理后台-接口地址: /admin-api/lowcode/deploy-api/{apiName}/select-count
用户端-接口地址: /app-api/lowcode/deploy-api/{apiName}/select-count
请求方式: POST
接口描述: 根据查询条件,统计符合条件的数据总数
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 |
|---|---|---|---|
apiName | 接口名称 | 路径参数 | 是 |
apiCode | 接口编码 | 查询参数 | 否 |
queryDomainParams | 请求参数 | 请求体 | 是 |
whereParams | 查询参数 | 否 | |
name | 查询字段名 | 是 | |
symbol | 查询符号类型 | 是 | |
value | 查询值(取决于 symbol 类型) | 取决于 symbol | |
values | 查询值数组(取决于 symbol 类型) | 取决于 symbol |
💡 使用提示
symbol的值需匹配QueryDomainSymbolType枚举(如EQ/LIKE/BETWEEN)value和values的实际值类型由symbol决定(例如BETWEEN需传入数组[min, max],IN需传入列表)
响应参数:
| 参数名称 | 参数说明 | 类型 |
|---|---|---|
code | 状态码 | Integer |
msg | 返回信息 | String |
data | 符合条件的记录总数 | Long |
请求示例:
{
"whereParams": [
{
"name": "",
"symbol": "",
"value": {},
"values": []
}
]
}响应示例:
{
"code": 0,
"msg": "",
"data": 0
}export 数据导出接口
管理后台-接口地址: /admin-api/lowcode/deploy-api/{apiName}/export
用户端-接口地址: 用户端不支持导出
请求方式: POST
接口描述: 根据查询条件,导出符合条件的数据(Excel文件流)
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 |
|---|---|---|---|
apiName | 接口名称 | 路径参数 | 是 |
apiCode | 接口编码 | 查询参数 | 否 |
queryDomainParams | 请求参数 | 请求体 | 是 |
pageParams | 分页参数) | 否 | |
sortingFields | 排序参数 | 否 | |
field | 排序字段 | 否 | |
order | asc desc | 否 | |
whereParams | 查询参数 | 否 | |
name | 查询字段名 | 是 | |
symbol | 查询符号类型 | 是 | |
value | 查询值(取决于 symbol 类型) | 取决于 symbol | |
values | 查询值数组(取决于 symbol 类型) | 取决于 symbol |
💡 使用提示
symbol的值需匹配QueryDomainSymbolType枚举(如EQ/LIKE/BETWEEN)value和values的实际值类型由symbol决定(例如BETWEEN需传入数组[min, max],IN需传入列表)- 实际导出行为由后端实现决定,最多导出 1000000 条数据
响应说明:
- 成功时返回文件流(如 Excel、CSV),HTTP 状态码为
200 - 响应头通常包含
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet或类似 MIME 类型 - 无结构化 JSON 响应体
请求示例:
{
"pageParams": {
"sortingFields": [
{
"field": "",
"order": ""
}
]
},
"whereParams": [
{
"name": "",
"symbol": "",
"value": {},
"values": []
}
]
}响应示例:
(无 JSON 响应体,直接返回文件流)
前端使用示例
async () => {
await message.exportConfirm()
const resp = await request({
url: '/lowcode/deploy-api/{apiName}/export',
method: 'POST',
responseType: 'blob',
data: {}
})
download.excel(data, `测试导出.xls`)
}