查询多条数据库数据 | potato cloud开放文档

# 查询多条数据库数据

# 简要描述

进行查询数据库数据，如果有多条数据匹配，将会返回全部信息数据，如果结果超过1000条则需要分页查询，默认第1页，每页1000条，支持表达式查询 , {}包起来的参数名称表示该参数名称不是固定的，

# 请求URL

/api/selectList/{tableName}

# 请求头

参数名	必选	类型	说明
Content-Type	是	string	此参数必传，当请求数据非json时此参数传对应格式如（multipartform-data，application/x-www-form-urlencoded，等）是json请传application/json
askKey	是	string	此参数必传,验证app的令牌
sign	否	string	此参数如果在app设置开启了验签是必传
time	否	string	当开启验签时，此参数为必传
apiUserToken	否	string	用户令牌
nonce	否	string	随机字符串(当开启V3验签此参数必传，且6分钟内不允许重复)

# 请求方式

post

# 路由参数

参数名	必选	类型	说明
{tableName}	是	string	表名称

# 参数

参数名	必选	类型	说明
where	否	array	条件对象数组；代码只解析该字段作为查询条件
pc	否	object	分页信息,默认第一页,每页1000条

# 参数简介

tableName为表的名称，表即为土豆api里面创建的表的名称，需要跟在地址栏后面，如果表名称为test则请求的路径为/api/selectList/test,
where为条件对象数组，支持多个条件查询；每一项含 reg（缺省 eq）、column、value
pc 分页信息对象,默认第1页，每页1000条，在数据量过大的情况下，需要支持分页，默认p为1，s为1000
reg 取值：eq 等于、le 小于、lte 小于等于、gt 大于、gte 大于等于、ne 不等于、in / nin、like_contains / like_prefix / like_suffix
顶层不要单独传 reg/column/value，实现不会读取

# 请求示例

{
	"where": [
		{
			"reg": "eq",
			"column": "id",
			"value": "1"
		},
		{
			"reg": "le",
			"column": "id",
			"value": "3"
		}
	],
	"pc": {
		"p": 10,
		"s": 1000
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# 返回示例

{
	"code": "200",
	"message": "",
	"status": true,
	"data": [
		{
			"name": "1",
			"id": 1
		}
	],
	"pc": null,
	"time": null,
	"sign": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 返回参数说明

参数名	类型	说明
code	string	状态码200成功,403权限异常或登录超时,500请求异常,203请求无数据
status	int	状态0删除1使用
data	json	更新对象
nonce	string	随机字符串(当开启V3验签必返回次参数，且6分钟内不会重复)
sign	string	此参数如果在app设置开启了验签是必返
reqSign	string	请求签名
time	long	当开启验签时，此参数为必返回

# 备注

更多返回错误代码请查看错误代码参考

← 查询一条数据库数据添加一条数据 →