查询数据视图数据

• 描述
• 使用须知
• 接口URL
• 名词解释
• 请求参数
• 请求示例
• 响应参数
• 响应数据样例

描述

根据数据筛选条件查询数据视图数据

使用须知

开发前，请仔细阅读开发指南。

• POST请求头

{"Authorization": "Bearer YOUR_APIKEY"}

• YOUR_APIKEY请阅读开发指南了解。

接口URL

POST - /openapi/v1/app/{app_id}/etl/{entry_id}/data

名词解释

名称	说明
app_id	应用ID
entry_id	该应用内的数据视图输出表ID

app_id+entry_id表示全局唯一的数据视图标识，前往开放平台中的API文档进行查看或通过获取数据视图列表接口查询。

请求参数

参数名	示例值	参数类型	是否必填	参数描述
skip	0	Number	否	翻页起始值索引
limit	20	Number	否	查询的数据条数，1~100，默认100
fields	单行文本	Array	否	查询字段，不填查所有
filter		Object	否	数据筛选器
filter.rel	and	String	否	筛选组合关系，and或or
filter.cond		Array	否	过滤条件列表
filter.cond.field	单行文本	String	否	字段别名
filter.cond.method	eq	String	否	过滤方法
filter.cond.value	张三	Array	否	过滤值

请求示例

{
    "skip": 0,
    "limit": 20,
    "fields": [
        "单行文本",
        "多行文本"
    ],
    "filter": {
        "rel": "and",
        "cond": [
            {
                "field": "单行文本",
                "method": "eq",
                "value": [
                    "张三"
                ]
            }
        ]
    }
}

响应参数

参数名	示例值	参数类型	参数描述
count	17	Number	符合的数据条数
data	-	Object	返回数据

响应数据样例

{
    "count": 17,
    "data": [
        {
            "单行文本": "张三",
            "多行文本": "webapi",
            "数字": 8,
            "日期时间": "2019-01-01 00:00:00",
            "单选按钮组": "一年级",
            "复选框组": [
                "选项1"
            ],
            "下拉框": "女",
            "下拉复选框": [
                "选项1"
            ],
            "地址": {
                "province": "湖南省",
                "city": "长沙市",
                "district": "芙蓉区",
                "detail": "韶山北路"
            },
            "定位": {
                "province": "湖南省",
                "city": "长沙市",
                "district": "芙蓉区",
                "detail": "韶山北路",
                "lnglatXY": [
                    112.99627
                ]
            },
            "图片": [
                {
                    "name": "123.jpg",
                    "size": 68065,
                    "mime": "image/jpeg",
                    "url": "https://www.xxxxx.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz"
                }
            ],
            "附件": [
                {
                    "name": "新建文本文档.txt",
                    "size": "0",
                    "mime": "text/plain",
                    "url": "https://www.xxxxx.com/Fto5o-5ea0sNMlW_75VgGJCv2AcJ"
                }
            ],
            "流水号": "00019",
            "手写签名": [
                {
                    "name": "bbysignature_1643017609786.png",
                    "size": "7936",
                    "mime": "image/png",
                    "url": "https://www.xxxxx.com/FkQDnvlHUOrHkBcDtS8fWdOulc3z"
                }
            ],
            "成员单选": {
                "name": "张三",
                "_id": "5577ebc4504e8e77036d2a09"
            },
            "成员多选": [
                {
                    "name": "张三",
                    "_id": "5577ebc4504e8e77036d2a09"
                }
            ],
            "部门单选": {
                "name": "人事部",
                "_id": "51d1177b964603db9e60a962"
            },
            "部门多选": [
                {
                    "name": "人事部",
                    "_id": "51d1177b964603db9e60a962"
                }
            ],
            "提交人": {
                "name": "李四",
                "_id": "5d66359813f33ef2e45916f2"
            },
            "提交时间": "2022-01-19 15:37:40",
            "更新时间": "2022-01-24 17:47:03",
            "数据ID": "5f88732bc72f7213fb1b0786"
        }
    ]
}