API 列表

xiaodian.org.employee.querySingleEmployee

  • 免费
  • 无需授权

API功能描述(支持get和post)

查询单个员工信息

公共参数

名称 类型 必选 描述
app_key Long 是 接入时申请的app_key
method String 是 接口名称
access_token String 是 Oauth2.0授权获得的access_token
sign String 是 对 API 调用参数（除sign外）进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp Long 是 时间戳，使用Unix时间戳格式
format String 是 响应格式。默认为json格式，固定
sign_method String 否 参数的加密方法选择，当前只支持Md5
version String 否 API协议版本，固定值为：1.0

输入参数

名称 类型 必选 描述 示例值
singleEmployeeQueryDto Object 是 查询单个员工的查询对象
employeeId String 是 员工id(id，工号，三方工号不许都为空)
employeeNo String 是 员工工号
thirdEmployeeNo String 是 三方员工编码

返回参数

名称 类型 描述 默认值
status Object 状态对象
code String 状态码 0000000
msg String 状态信息 请求成功
result Object 返回结果
data Object 结果数据
birthday Number 生日 907171200
deptName String 部门名称 西湖大区
channel Number 渠道 0
employeeNo String 员工编号 00000004
idNo String 证件编号 421181199801012135
id Number 员工id 66
thirdEmployeeNo String 三方员工编号 13212345434
idType Number 证件类型 1
entryDate Number 入职时间精确到秒 1601481600
thirdId String 三方员工id
created Number 员工创建时间精确到秒 1608089981
nickName String 昵称 向东
sex Number 性别 1
deptId String 部门id 11u
mobile String 手机号 13212345434
companyId Number 公司id 26
employeeType Number 员工类型 0
brandId Number 品牌id 1302424855
leaveDate Number 离职时间精确到秒 0
name String 姓名 向东
isVirtual Boolean 是否是虚拟员工 false
position String 职位 前端工程师
updated Number 员工最后修改时间精确到秒 1608091060
age Number 年龄 20
status Number 员工状态 2
success Boolean 是否成功 true

请求参数示例

1).
{
    "singleEmployeeQueryDto":{
        "employeeId":66
    }
}

返回示例

1).
{
	"status": {
		"code": "0000000",
		"msg": "请求成功"
	},
	"result": {
		"data": {
			"birthday": 907171200,
			"deptName": "西湖大区",
			"channel": 0,
			"employeeNo": "00000004",
			"idNo": "421181199801012135",
			"isDeleted": false,
			"id": 66,
			"thirdEmployeeNo": "13212345434",
			"idType": 1,
			"entryDate": 1601481600,
			"thirdId": "",
			"created": 1608089981,
			"nickName": "向东",
			"sex": 1,
			"deptId": "11u",
			"mobile": "13212345434",
			"companyId": 26,
			"employeeType": 0,
			"brandId": 1302424855,
			"leaveDate": 0,
			"name": "向东",
			"isVirtual": false,
			"position": "前端工程师",
			"updated": 1608091060,
			"age": 20,
			"status": 2
		}
	},
	"success": true
}

异常示例

API测试工具