跳到主要内容

获取应用数据

获取轻流系统中指定应用的数据。

权限说明​

「超级管理员accessToken」和「权限组accessToken」都可以调用，「权限组accessToken」须具有该应用的权限，以及数据管理的权限。

请求​

**请求方式：**POST

**请求地址：**https://api.qingflow.com/app/:appkey/apply/filter（公有云版本）

请求地址中:appkey为需要替换的变量，根据实际获取值更新，示例如下：

POST https://api.qingflow.com/app/1fa752c0/apply/filter

其他版本请求地址：

钉钉版本：https://api.ding.qingflow.com/app/:appkey/apply/filter

专有轻流：http(s)://xxx.xx(自有域名)/openApi/app/:appkey/apply/filter

2.1 参数说明(路径参数)​

参数必须说明
appKey是应用ID，获取方式参考：基本概念介绍——appKey

2.2 请求头（Header）​

参数必须说明
accessToken是调用接口凭证。获取方法请查看“文档”
userId非必填说明：用户的userId，type值为非8的情况下需要传输用户信息

2.3 请求体（Body）​

参数必须类型说明
pageSize是int每页数据条数
pageNum是int请求页码
sorts[array]排序情况
queIdint字段Id，specialQueId可见文档
isAscend[boolean]是否升序，true：升序
queriesRelstring针对字段的查询条件之间逻辑关系，目前支持and、or，默认为and。多条件查询时在queries数组中以多个对象形式存在
queries[array]针对字段的查询条件
queId是int如果设置了筛选查询条件，此处为必填项，specialQueId可见文档
searchKeystring搜索关键字
searchKeys[array]数组内的字段为或条件搜索，当searchKey不为null的时候此字段会被忽略
minValuestring数字模块中，是搜索结果中最小值；日期类型，就是最早日期（仅填写年月日信息系统会自动补齐00：00：00）
maxValuestring数字模块中，是搜索结果中最大值；日期类型，就是最晚日期（仅填写年月日信息系统会自动补齐00：00：00，若需包含当天所有数据，需将最晚日期设为年-月-日 23:59:59）
scopeint筛选数据范围， 1：全部，2：已填写，3：未填写
searchOptions[array]单选多选中，搜索答案中包含这些选项的申请，由optionId组成
searchUserIds[array]成员字段中，搜索答案中包含这些userId的申请
queryKeystring模糊搜索全部字段数据的key值
applyIds[array]指定申请的applyId

2.4 请求体示例​

{
	"pageSize": 50,
	"pageNum": 1,
	"type": 1,
	"sorts": [
			{
					"queId": 1,
					"isAscend": true
		  }
	],
	"queriesRel": "and",
	"queries": [
			{
					"queId": 0,
					"searchKey": "ss",
					"searchKeys": [
							"aa",
							"bb"
			],
			"minValue": "",
			"maxValue": "",
			"scope": 1,
			"searchOptions": [
					100
			],
			"searchUserIds": [
					"abc"
			]
		}
	],
	"queryKey": "",
	"applyIds": [
			1
	]
}

返回​

3.1 返回体​

参数必须类型说明
errCode是string错误码，非0表示失败
errMsg是string错误描述
questionRelations关联的设置，这里没用
result是object返回结果
pageAmount是int页数
pageNum是int起始页码
pageSize是int每页数量
resultAmount是int结果总数
result是array
answers是array
queId是int字段Id.必填，specialQueId可见文档
queTitle是string字段标题
queType是int字段类型。queType可见文档1、描述文字；2、单行文字；3、多行文字；4、日期时间；5、成员字段；6、邮箱；7、手机；8、数字；9、链接；10、单项选择；11、下拉选择；12、多项选择；13、上传附件；14、起止时间；15、图片选择；16、富文本；17、定位字段；18、表格；19、数据关联；20、Q-Linker；21、地址字段；22、部门字段；
tableValues是array[["$ref:answerDetail"]] 表格类型字段必填
values是array表格字段以外的字段类型必填
valuestring问题的结果值
otherInfostring问题结果的其他信息,上传文件这里是文件名,选择类的其他选项这里是其他选项填写的内容
idint选择类型，为optId，成员类型，为uid；成员字段 ，当前用户: -1；地址字段，1-4：省、市、区、详细地址
applyId是string这条数据的id
applyBaseInfostring一条数据的基础信息，调用开放接口时不会赋值

3.2 返回体示例​

{
    "errCode": 0,
    "errMsg": null,
    "questionRelations": [],
    "result": {
        "pageAmount": 1,
        "pageNum": 1,
        "pageSize": 50,
        "result": [
            {
                "answers": [
                    {
                        "associatedQueType": null,
                        "queId": 0,
                        "queTitle": "编号",
                        "queType": 8,
                        "referValues": [],
                        "supId": null,
                        "tableValues": [],
                        "values": [
                            {
                                "dataValue": "4",
                                "email": null,
                                "id": null,
                                "ordinal": null,
                                "otherInfo": null,
                                "pluginValue": null,
                                "queId": 0,
                                "value": "4"
                            }
                        ]
                    }
								],
                "applyBaseInfo": null,
                "applyId": 50809061
            }
        ],
        "resultAmount": 4
    }
}