沃土开放平台

API文档 > 人员管理类 > 人员搜索接口
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/people/search,method:POST
  • 发送查询条件至云端,若所有条件为空则返回该appId下注册的所有人员信息
  • 若人员有tag,则需按tag搜索才能找到人员
  • 若搜索条件不传入tag,则搜索范围是无tag的人员

根据具体需求查询该appId下符合条件的所有人员

  • startTime和endTime可查询在某阶段时间内录入的所有人员
  • index相当于可跳转到目标页码
  • length可设置每页显示的人数,若为空则默认为每页数量为5
  • 搜索字段暂只支持精确查询,即输入人员姓名时需要完整的人员姓名,不能按姓氏搜索
注意:本接口搜索字段暂只支持精确查询
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
name 姓名 String N
tag 标签 String N
idNo 卡号(IC卡/身份证) String N
phone 电话 String N
startTime 录入时间初始 Date N
endTime 录入时间末尾 Date N
length 每页数量 Int N
type 人员类型 Int N 由客户自行定义,支持正整数,0没有意义,允许更新为空
index 页码 Int N
guid 人员guid String N
userGuid 人员所有者(客户)guid String N
orderFieldKey 按照某字段排序 Int N 1:GUID //人员guid
2:USER_GUID //人员所有者(客户)guid
3:NAME //人员姓名
4: ID_NO //身份证
5:PHONE //手机号
6:CREATE_TIME //创建时间
默认CREATE_TIME
orderTypeKey 升降序 Int N 1:ASC //升序
2:DESC //降序;
默认升序
{
	"code": "GS_SUS208",//人员列表查询接口调用成功
	"data": {
	"content": [
		{
		"guid": "06FEAC98DBED4546AC6E474BE3D4374C",//人员guid
		"userGuid": 73,//人员所有者(客户)guid
		"createTime": "2017-06-13T03:22:26.601Z",//创建时间
		"appId": "BEC39FBDF6D94E3798AFB19DDF051234",//应用Id
		"phone": "13777821234",//手机号
		"idNo":"",//卡号(IC卡/身份证)
		"tag":"",//人员标记(加密)
		"type":"0",//人员类型(由客户自行定义,支持正整数,0没有意义)
		"name":"测试姓名"//人员姓名
		}
	],
	"pagination": {//分页信息
		"total": 1,//总条目数
		"size": 1,//总页数
		"index": 1,//当前页数
		"length": 5,//每页最大显示数量,默认5
		"beginIndex": 0,//分页开始条目于总数位置
		"endIndex": 1//分页结束条目于总数位置
		}
	},
	"msg": "success",
	"result": 1
}