API开发文档 - 道一云

开发说明

开发说明

功能说明：获取会议详情列表
请求方式：POST（HTTPS）multipart/form-data
请求地址：https://qwif.do1.com.cn/qwcgi/api/meet/getMeetingList.do?token=token&corpId=corpId

请求包体：

{
	"currentPage":1,
	"endTime":"2020-01-31",
	"isShowPrivacy":1,
	"pageSize":10,
	"startTime":"2020-01-01"
}

请求参数说明：

参数	类型	说明	是否必需	备注
token	string	用于验证	是
corpId	string	公司唯一标识	是
currentPage	number	查询页码	是
pageSize	number	分页大小	否	默认为100,并且不超过1000
startTime	String	更新时间上限	是	格式必须为:yyy-MM-dd
endTime	String	更新时间上限	是	创建时间间隔不得超过两个月
isShowPrivacy	number	是否返回人员的邮箱和手机号：0-否，1-是（默认不开启）	否

SDK调用示例：

        ApiMeetGetMeetingListVO paramVO = new ApiMeetGetMeetingListVO();
        // 分页页码
        paramVO.setCurrentPage(1);
        // 分页大小
        paramVO.setPageSize(10);
        // 更新时间下限
        paramVO.setStartTime("2020-01-01");
        // 更新时间上限
        paramVO.setEndTime("2020-01-31");
        // 需要返回人员的邮箱和手机号
        paramVO.setIsShowPrivacy(1);

        MeetApi meetApi = QwSdkUtil.getInter(MeetApi.class);
        // 调用接口
        ApiMeetingPager resultVO = meetApi.getMeetingList(QwSdkUtil.getCacheToken(), paramVO);
        // 打印输出结果
        System.out.println(JSONUtil.stringify(resultVO));

返回结果：

{
	"code":"0",
	"data":
	{
		"currPage":1,
		"maxPage":1,
		"pageData":
		[
			{
				"auditPerson":
				{
					"auditPersonName":"企小微",
					"auditReason":"同意",
					"auditUserId":"81349acd162371a400afa7008ff3e5f8"
				},
				"auditResult":0,
				"ccPersons":
				[
					{
						"approvalPersonName":"企小微",
						"approvalReason":"审批意见示例",
						"approvalStatus":3,
						"approvalUserId":"81349acd162371a400afa7008ff3e5f8",
						"departmentId":"2d209e6febb7e6f4141e21f08ed923be",
						"departmentName":"部门名称示例",
						"isOut":0,
						"mobile":"13801023456",
						"personName":"企小二",
						"reason":"请假理由示例",
						"status":"1",
						"type":"1",
						"userId":"df00508768f97083a0f779e6f136f4cf"
					},
					{
						"approvalStatus":0,
						"departmentId":"2d209e6febb7e6f4141e21f08ed923be",
						"departmentName":"部门名称示例",
						"email":"daoxiaoyi@qq.com",
						"isOut":0,
						"mobile":"13801023456",
						"personName":"道小一",
						"signTime":"2019-01-03 16:55:57",
						"status":"2",
						"type":"1",
						"userId":"539b7b5d7c2b12c34ead553d20776fc0"
					},
					{
						"approvalStatus":0,
						"departmentId":"2d209e6febb7e6f4141e21f08ed923be",
						"departmentName":"部门名称示例",
						"isOut":0,
						"mobile":"13801023456",
						"personName":"企小微",
						"status":"0",
						"type":"1",
						"userId":"3e41bddd692f89a25c1199e01f173374"
					},
					{
						"approvalStatus":0,
						"departmentId":"2d209e6febb7e6f4141e21f08ed923be",
						"departmentName":"部门名称示例",
						"email":"qixiaowei@qq.com",
						"isOut":0,
						"mobile":"13801023456",
						"personName":"企小微",
						"status":"0",
						"type":"1",
						"userId":"8890bc5883cbec630969d9789a5fec4a"
					}

				],
				"comments":
				{
					"currentPage":2,
					"formNumber":0,
					"pageData":
					[
						{
							"content":"评论内容示例1",
							"createTime":"2019-01-03 16:53:47",
							"creator":"81349acd162371a400afa7008ff3e5f8",
							"departmentName":"部门名称示例",
							"personName":"企小微"
						},
						{
							"content":"评论内容示例2",
							"createTime":"2019-01-03 16:51:12",
							"creator":"81349acd162371a400afa7008ff3e5f8",
							"departmentName":"部门名称示例",
							"personName":"企小二"
						}

					],
					"pageSize":10,
					"startRow":10,
					"totalPages":2,
					"totalRows":12
				},
				"content":"内容示例",
				"createTime":"2019-01-03 16:50:09",
				"creator":"81349acd162371a400afa7008ff3e5f8",
				"cycleList":
				{
					"cycleWeek":0,
					"day":0,
					"isEveryday":1,
					"isFestival":0,
					"month":0,
					"overTime":"2019-01-21 16:45:00",
					"week":"-1"
				},
				"departmentId":"66e9bda3d1b114f426fcc369606d8d74;d08633978cda09c03452e5176f0b0f29",
				"departmentName":"父部门1->子部门1;父部门2",
				"email":"qixiaowei@qq.com",
				"endTime":"2019-01-03 20:00:00",
				"id":"3633bf4b-2527-4c25-ac93-e61abad7ce4e",
				"mediaList":
				[
					{
						"fileName":"附件名称示例.docx",
						"url":"/upload/file/02f5ca343129495bad85d162d2bd5b34/20190103/720d428d13a14aa78e07fe23ab6acb84.docx"
					},
					{
						"fileName":"附件名称示例.docx",
						"url":"/upload/file/02f5ca343129495bad85d162d2bd5b34/20190103/b45d7bdc2bae4ee5833b0d9955bbfae9.docx"
					}

				],
				"mobile":"18801235678",
				"personName":"企小微",
				"picList":
				[
					"/upload/img/02f5ca343129495bad85d162d2bd5b34/20190103/d5ecd09aed8f40a6aa8b6ee56d495dbd.jpeg",
					"/upload/img/02f5ca343129495bad85d162d2bd5b34/20190103/46e3dc46b0584e0f89c0d2d1a2918819.jpeg"
				],
				"regionId":"dec1e771-3ee9-43c2-81a9-bf0d626affda",
				"regionName":"会议区域名称示例",
				"roomName":"会议室名称示例",
				"serPersons":
				[
					{
						"approvalStatus":0,
						"departmentId":"2d209e6febb7e6f4141e21f08ed923be",
						"departmentName":"部门名称示例",
						"isOut":0,
						"personName":"企小微",
						"status":"0",
						"type":"3",
						"userId":"7e1faa2dcf63ec02e25cbc9fe4e7badd"
					}

				],
				"serviceContent":"内容示例",
				"startTime":"2019-01-03 17:00:00",
				"status":"2",
				"sumPersons":
				[
					{
						"approvalStatus":0,
						"departmentId":"2d209e6febb7e6f4141e21f08ed923be",
						"departmentName":"部门名称示例",
						"isOut":0,
						"personName":"企小微",
						"status":"0",
						"type":"3",
						"userId":"7e1faa2dcf63ec02e25cbc9fe4e7badd"
					}

				],
				"title":"标题示例",
				"toPersons":
				[
					{
						"approvalStatus":0,
						"departmentId":"2d209e6febb7e6f4141e21f08ed923be",
						"departmentName":"部门名称示例",
						"email":"qixiaowei@qq.com",
						"isOut":1,
						"mobile":"13801023456",
						"personName":"企小微",
						"signOutTime":"2019-01-03 16:53:48",
						"signTime":"2019-01-03 16:53:47",
						"status":"2",
						"type":"0",
						"userId":"81349acd162371a400afa7008ff3e5f8"
					},
					{
						"approvalStatus":0,
						"departmentId":"2d209e6febb7e6f4141e21f08ed923be",
						"departmentName":"部门名称示例",
						"isOut":0,
						"mobile":"13801023456",
						"personName":"企小二",
						"status":"0",
						"type":"0",
						"userId":"7c753c86e8b5aa304bd10289b1621a2a"
					}

				]

			}

		],
		"pageSize":10,
		"totalRows":2
	},
	"desc":"成功"
}

返回参数说明：

参数	说明
currentPage	当前页
totalRows	信息总条数
totalPages	信息总页数
pageSize	每页信息条数

pageData 参数说明

参数	类型	说明
auditPerson	json	审批人信息
auditResult	number	审批结果：0-通过，1-待审批，2-不通过，3-审批过期
ccPersons	json	参会人信息
comments	json	评论信息
content	string	会议内容
createTime	string	创建时间 yyyy-MM-dd HH:mm:ss
creator	string	创建人id
cycleList	json	周期规则信息
mobile	string	创建人手机号
email	string	创建人邮箱
departmentId	string	创建人部门id
departmentName	string	创建人部门
endTime	string	会议结束时间 yyyy-MM-dd HH:mm:ss
id	string	会议id
mediaList	json	附件信息
personName	string	创建人名字
picList	json	图片url数组
regionId	string	区域id
regionName	string	区域名
roomName	string	会议室名称
serPersons	json	会服人员信息
serviceContent	string	会服内容
startTime	string	会议开始时间 yyyy-MM-dd HH:mm:ss
status	string	会议状态：0-草稿，1-已发布，2-已结束，3-已取消
sumPersons	json	会议纪要人员信息
title	string	会议标题
toPersons	json	发起人信息

auditPersons 参数说明

参数	类型	说明
auditPersonName	string	审批人名字
auditUserId	string	审批人id
auditReason	string	审批意见

toPersons / ccPersons / serPersons / sumPersons 参数说明

参数	类型	说明
approvalPersonName	string	请假审批人的名字
approvalReason	string	请假审批意见
approvalStatus	number	请假状态：0-不需要审批的状态，1-待审批，2-审批通过，3-审批不通过
approvalUserId	string	请假审批人id
mobile	string	人员手机号（仅发起人/参会人）
email	string	人员邮箱（仅发起人/参会人）
departmentId	string	人员所属部门id
departmentName	string	人员所属部门名
isOut	number	是否已经签退：0-否，1-是
personName	string	人员名字
reason	string	请假理由
signOutTime	string	签退时间 yyyy-MM-dd HH:mm:ss
signTime	string	签到时间 yyyy-MM-dd HH:mm:ss
status	string	人员状态：0-未确认，1-已确认，2-已签到，3-请假
type	string	人员类型：0-发起人，1-参会人，2-会议纪要记录人，3-会服人员，4-@相关人
userId	string	人员id

comments.pageData 参数说明

参数	类型	说明
content	string	评论内容
createPerson	string	评论人id
createTime	string	评论时间 yyyy-MM-dd HH:mm:ss
departmentName	string	评论人部门
personName	string	评论人名字

cycleList 参数说明

参数	类型	说明
cycleWeek	number	几周循环一次
isEveryday	number	频率是否为每天：0-否，1-是
isFestival	number	是否跳过节假日：0-否，1-是
week	string	频率：每周工作日：week=1,2,3,4,5（即周一到周五） day=0 month=0 每周：week=0（即周日） day=0 month=0 每月：week=-1 day=2（即2号） month=0 每年：week=-1 day=2（即2号） month=1（即1月） ps：week=0代表周日，week=1~6代表周一至周六
day	number
month	number
overTime	string	周期结束时间 yyyy-MM-dd HH:mm:ss

mediaList 参数说明

参数	类型	说明
fileName	string	附件名字
url	string	附件url

企业微信

获取会议详情列表

开发说明