工作轨迹接口

参数名称 参数值
应用编码 track
应用版本 v1
接口名称 新增轨迹
接口编码 addUserTrack
接口URL https://openapi.waiqin365.com/api/track/v1/addUserTrack/{openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
emp_id VARCHAR(32) 来源第三方系统的唯一ID,和id字段二者至少填一个,同时存在时以id优先
id VARCHAR(32) 员工外勤365唯一ID,和emp_id字段二者至少填一个,同时存在时以id优先
imsi VARCHAR(32) IMSI号
esn VARCHAR(32) ESN号
locationmode VARCHAR(100) 坐标类型,gps:GPS坐标;gcj:囯测局坐标
longitude VARCHAR (100) 经度:118.725327
latitude VARCHAR(100) 纬度:31.985632
accuracy VARCHAR(32) 定位经度范围,默认500米
locationtime VARCHAR(32) 定位时间,格式“yyyy-MM-dd HH:mm:ss”
gpsopen VARCHAR(32) GPS开启状态,1-开启;0关闭,默认0
netopen VARCHAR(32) 网络打开时间,1-打开;0关闭,默认1
locationtype VARCHAR(32) 定位数据来源,0-GPS;1-基站;2-WIFI;3-网络;9-其他
startuptime VARCHAR(32) 开机保持时间
battery VARCHAR(32) 电量
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
"id":"6241959536689640531",
"emp_id":"khzh_source_code",
"imsi":"460037520900801",
"esn":"A1000049CD03A2",
"locationinfos":[
	{
		"locationmode":"gcj",
		"longitude":"118.725327",
		"latitude":"31.985632",
		"accuracy":"35",
		"locationtime":"2018-03-16 15:40:22",
		"gpsopen":"0",
		"netopen":"1",
		"locationtype":"2",
		"startuptime":"287329",
		"battery":"44"
	}
]
}

// 响应信息示例:
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}
                  
参数名称 参数值
应用编码 track
应用版本 v1
接口名称 查询轨迹
接口编码 queryUserTrack
接口URL https://openapi.waiqin365.com/api/track/v1/queryUserTrack/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
page_number INT 页码默认1,每页最大1000条
emp_id VARCHAR(32) 来源第三方系统的唯一ID,和id字段二者至少填一个,同时存在时以id优先
id VARCHAR(32) 员工外勤365唯一ID,和emp_id字段二者至少填一个,同时存在时以id优先
starttime VARCHAR(32) 定位开始时间,格式“yyyy-MM-dd HH:mm:ss”
endtime VARCHAR(32) 定位结束时间,格式“yyyy-MM-dd HH:mm:ss”
响应信息 参照表响应信息格式
waiqin365_emp_id VARCHAR(32) 外勤365员工唯一标识
update_time VARCHAR(32) 定位时间,格式“yyyy-MM-dd HH:mm:ss”
gps_loc VARCHAR(100) 坐标
address VARCHAR(500) 地址
prov_name VARCHAR(100) 省份
prov_code VARCHAR(32) 省份编码
city_name VARCHAR(100) 城市
city_code VARCHAR(32) 城市编码
district_name VARCHAR(100) 区县
district_code VARCHAR(32) 区县编码
area_name VARCHAR(100) 道路
area_code VARCHAR(32) 道路编码

// 请求消息体示例:
{
	"id": "6241959536689640531",
	"emp_id": "khzh_source_code",
	"starttime": "2018-3-15 15:40:22",
	"endtime": "2018-3-20 16:40:22"
}

// 正常响应信息示例:
{
	"return_code": "0",
	"return_msg": "查询成功",
	"msg_id": "ORG00001",
	"response_data": "[
		{
			"district_code": "610115",
			"prov_code": "610000",
			"city_name": "西安市",
			"district_name": "临潼区",
			"update_time": "2018-03-19 14:42:43",
			"address": "陕西省西安市临潼区",
			"area_code": "0",
			"area_name": "",
			"waiqin365_emp_id": 6241959536689640531,
			"gps_loc": "34.560871,109.204102",
			"city_code": "610100",
			"prov_name": "陕西省"
		},
		{
			"district_code": "320102",
			"prov_code": "320000",
			"city_name": "南京市",
			"district_name": "玄武区",
			"update_time": "2018-03-19 14:43:06",
			"address": "江苏省南京市玄武区珠江路634号",
			"area_code": "0",
			"area_name": "珠江路",
			"waiqin365_emp_id": 6241959536689640531,
			"gps_loc": "32.047344,118.802422",
			"city_code": "320100",
			"prov_name": "江苏省"
		}
	
	]"
}

// 异常响应信息示例:
{
    "msg_id": "PRD00001",
    "return_code": 1,
    "return_msg": "查询日期格式不合法!"
}