沃土开放平台

API文档 > 人员管理类 > 人员录入接口
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/person,method:POST
  • 发送人员姓名、卡号(IC卡/身份证)、手机号等至云端,云端服务器存入该人员信息并生成一个guid并保存,相当于进行人员注册
  • 注册成功后会返回服务器分配的人员编号guid,简称人员id
  • tag(加密,数据存储隔离)为人员标签,用于标记人员聚类,如:不同公司的人员
  • type为人员类型,用于人员归类,如:一个公司的各个部门/职位

注册一个新的人员,在云端添加(录入)一个新的人员

  • 人员姓名格式:限制32个字符,只允许数字、英文、中文、中英文符号;名字过长可能会导致屏幕显示不下
  • 身份证处若使用其他编号标记,限制32个字符
  • tag传入后,服务器会返回加密形式后的tag,可用于人员分类
  • 人员搜索时,若人员有tag,则需按tag搜索才能找到人员;若搜索条件不传入tag,则搜索范围是无tag的人员
  • "code": "GS_SUS200",//人员录入接口调用成功,人员信息存入云端服务器
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
name 人员姓名 String Y
idNo IC卡/身份证卡号 String N
phone 人员手机号 String N
tag 人员标签 String N 可自行定义
type 人员类型 Int N 可自行定义 ,支持正整数,0没有意义
{
	"code": "GS_SUS200",//人员录入接口调用成功
	"data": {
		"guid": "06FEAC98DBED4546AC6E474BE3D4374C",//人员guid
		"userGuid": 73,//人员所有者(客户)guid
		"createTime": "2017-06-13T03:22:26.601Z",//创建时间
		"appId": "BEC39FBDF6D94E3798AFB19DDF051234",//应用Id
		"phone": "",//手机号
		"idNo":"",//卡号(IC卡/身份证)
		"tag":"",//人员标记(加密)
		"type":"0",//人员类型(由客户自行定义,支持正整数,0没有意义)
		"name":"测试姓名"//人员姓名
	},
	"msg": "success",
	"result": 1
}