查询多条数据接口
POST
/v5/app/entry/data/list
接口调用
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| app_id | String | 是 | 应用ID |
| entry_id | String | 是 | 表单ID |
| data_id | String | 否 | 上一次查询数据结果的最后一条数据的ID，没有则留空 |
| fields | Array | 否 | 需要查询的数据字段 |
| filter | JSON | 否 | 数据筛选器 |
| limit | Number | 否 | 查询的数据条数，1~100，默认10 |
数据筛选器
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
| rel | 是 | String | 筛选组合关系；“and”(满足所有过滤条件), “or”(满足任一过滤条件) |
| cond | 是 | [JSON] | 过滤条件列表 |
{
"rel": "and", // 或者 "or"
"cond": [
// 过滤条件
]
}| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
| field | 是 | String | 字段名 |
| type | 否 | String | 字段类型 |
| method | 是 | String | 过滤方法：“not_empty”(不为空)，“empty”(为空)，“eq”(等于)，“in”(等于任意一个)，最多可传递 200 个“range”(在x与y之间，并且包含x和y本身)，“nin”(不等于任意一个)，最多可传递 200 个“ne”(不等于),“like”(文本包含)“verified“(表示填写了手机号且已验证的值)“unverified“(表示填写了手机号但未验证值) |
| value | 否 | Array | 过滤值 |
// 没有参数的过滤条件
{
"field": "_widget_1508400000001",
"type": "text",
"method": "empty"
}
// 有参数的过滤条件
{
"field": "flowState",
"type": "flowstate",
"method": "eq",
"value": [1]
}| 字段类型 | 支持的过滤方式 | 说明 |
|---|---|---|
| flowState | eq，ne | 流程状态，仅对流程表单有效 |
| 日期时间 | eq，ne，range，empty，not_empty | |
| 数字 | eq，ne，range，empty，not_empty | |
| 文本 | eq，ne，in，nin，empty，not_empty | 包括单行文本、下拉框、单选按钮组、流水号 |
| 手机 | like, verified, unverified, empty, not_empty | verified表示填写了手机号且已验证的值；unverified表示填写了手机号但未验证值 |
| 其他表单字段（子表单字段除外） | empty，not_empty |
{
"app_id": "59264073a2a60c0c08e20bfb",
"entry_id": "59264073a2a60c0c08e20bfd",
"data_id": "59e9a2fe283ffa7c11b1ddbf",
"limit": 100,
"fields": ["_widget_1508400000001", "_widget_1508400000002", "_widget_1508400000003"],
"filter": {
"rel": "and", // 或者 "or"
"cond": [
{
"field": "_widget_1508400000001",
"type": "text",
"method": "empty"
},
{
"field": "_widget_1508400000002",
"type": "number",
"method": "not_empty"
},
{
"field": "flowState",
"type": "flowstate",
"method": "eq",
"value": [0]
}
]
}
}| 参数 | 类型 | 说明 |
|---|---|---|
| data | Array | 多条数据的集合 |
{
"data": [{
"_id": "59e9a2fe283ffa7c11b1ddbe",
"appId": "59264073a2a60c0c08e20bfb",
"entryId": "59264073a2a60c0c08e20bfd",
"creator": {
"name": "小简",
"username": "xiaojian",
"status": 1,
"type": 0,
"departments": [1, 3],
"integrate_id": "xiaojian"
},
"createTime": "2017-10-20T22:41:51.430Z",
"updateTime": "2017-10-20T11:12:15.293Z",
"_widget_1432728651402": "A班",
"_widget_1615777739673": [{
"_id": "604ed0298e2ade077c7245f1",
"_widget_1615777739744": "子表单数据1"
},
{
"_id": "604ed0298e2ade077c7245f2",
"_widget_1615777739744": "子表单数据2"
}
]
},
{
"_id": "59e9a2fe283ffa7c11b1ddbf",
"appId": "59264073a2a60c0c08e20bfb",
"entryId": "59264073a2a60c0c08e20bfd",
"creator": {
"name": "小简",
"username": "xiaojian",
"status": 1,
"type": 0,
"departments": [1, 3],
"integrate_id": "xiaojian"
},
"createTime": "2017-10-20T22:41:51.430Z",
"updateTime": "2017-10-20T11:12:15.293Z",
"_widget_1432728651402": "B班",
"_widget_1615777739673": [{
"_id": "604ed0298e2ade077c7245f3",
"_widget_1615777739744": "子表单数据1"
},
{
"_id": "604ed0298e2ade077c7245f4",
"_widget_1615777739744": "子表单数据2"
}
]
}
]
}请求参数
Body 参数application/json
示例代码
返回响应
修改于 2024-11-07 11:40:36