API开发文档 - 道一云

开发说明

开发说明

功能说明：获取签到信息列表
请求方式：POST（HTTPS）multipart/form-data
请求地址：https://qwif.do1.com.cn/qwcgi/api/outwork/getOutworkSignInfo.do?token=token&corpId=corpId

请求包体：

{
    "startTimes":"2018-03-01",
    "endTime":"2018-03-31",
    "pageSize":100,
    "currentPage":1
}

请求参数说明：

参数	说明	类型	是否必须	备注
token	用于验证	String	是	详见道一云平台TOKEN接口文档
corpId	公司唯一标识	String	是	企业corpId
startTimes	创建时间开始点	String	是	时间格式为yyyy-MM-dd
endTime	创建时间结束点	String	是	创建时间间隔不的超过两个月
currentPage	查询页码	int	是	必须为正整数,如果当前页超过最大页数,则当前页默认为最大页
pageSize	分页大小	int	否	默认为100,并且不超过1000

SDK调用示例：

		OutworkSignVO vo = new OutworkSignVO();
		// 创建时间开始点
		vo.setStartTimes("2018-03-01");
		// 创建时间结束点
		vo.setEndTime("2018-03-31");
		// 查询页码
		vo.setCurrentPage(1);
		// 分页大小
		vo.setPageSize(100);
		// 打印传入参数
		System.out.println(JSONUtil.stringify(vo));

		OutworkApi api = QwSdkUtil.getInter(OutworkApi.class);
		// 调用接口
		OutworkSignResult result = api.getSignInfo(QwSdkUtil.getCacheToken(),
				vo);
		// 打印输出结果
		System.out.println(JSONUtil.stringify(result));

返回结果：

{
	"code":"0",
	"data":
	{
		"currPage":1,
		"maxPage":1,
		"pageData":
		[
			{
				"createTime":"2018-03-01 10:17:03",
				"endTime":"2018-03-02 17:39:41",
				"id":"1b12eec0-de18-46cc-accc-7ba50c9d6d7a",
				"latitude":"23.12500762939453",
				"longitude":"113.34707641601562",
				"outLatitude":"23.125009536743164",
				"outLongitude":"113.34706115722656",
				"outworkContent":"我在『广东省广州市天河区员村一横路5号』签到。",
				"signOutComtent":"我在『广东省广州市天河区员村一横路5号』签退。",
				"startTime":"2018-03-01 10:17:03",
				"stayingTime":"1天7.4小时",
				"wxUserId":"wuyin"
			},
			{
				"createTime":"2018-03-02 17:40:27",
				"endTime":"2018-03-02 17:43:26",
				"id":"c698d686-22d0-4d25-a933-c279891f0b15",
				"latitude":"23.125017166137695",
				"longitude":"113.3470458984375",
				"outLatitude":"23.125009536743164",
				"outLongitude":"113.34706115722656",
				"outworkContent":"我在『广东省广州市天河区员村一横路5号』签到。",
				"signOutComtent":"我在『广东省广州市天河区员村一横路5号』签退。",
				"startTime":"2018-03-02 17:40:27",
				"stayingTime":"3分钟",
				"wxUserId":"wuyin"
			}

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

返回参数说明：

参数	说明
currPage	当前页
pageSize	分页大小
maxPage	最大页
totalRows	信息总条数

pageData参数	说明
id	签到ID
wxUserId	创建人账号
createTime	创建日期，格式为yyyy-MM-dd HH:mm:ss，例如2018-03-01 10:17:03
startTime	签到时间，格式为yyyy-MM-dd HH:mm:ss，例如2018-01-01 10:17:03
endTime	签退时间，格式为yyyy-MM-dd HH:mm:ss，例如2018-03-02 17:39:41
stayingTime	停留时长，单位为分钟，时，天
latitude	签到纬度
longitude	签到经度
outLatitude	签退纬度
outLongitude	签退经度
outworkContent	签到内容
signOutComtent	签退内容

企业微信

获取签到信息列表

开发说明