API 列表

xiaodian.org.employee.add

  • 免费
  • 无需授权

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

输入参数

名称 类型 必选 描述 示例值
employee Object 是 员工对象
name String 是 员工姓名
nickName String 否 员工昵称
age Number 否 员工年龄
idType Number 否 员工Id类型 1:身份证 2:护照
idNo String 否 员工证件编号
sex Number 否 员工性别 1 男 2女 3其他
birthday Number 否 员工生日精确到秒的时间戳
mobile String 是 员工手机号
entryDate Number 否 员工入职时间
status Number 是 员工状态 1 待入职 2在职 3已离职
employeeType Number 是 员工类型  0:正式员工 1:实习生  2:外包  3:劳务  4:顾问
deptId String 否 部门Id
deptName String 否 部门名称
leaveDate Number 否 员工离职时间精确到秒
thirdEmployeeNo String 否 三方员工编码
position String 否 职位

返回参数

名称 类型 描述 默认值
status Object 状态
code String 状态码 0000000
msg String 状态消息 请求成功
result Object 返回结果对象
data Object 返回结果数据
birthday Number 生日 907171200
deptName String 部门名称 研发部
idType Number 身份证类型 1
entryDate Number 入职时间 1601481600
nickName String 昵称 向南
sex Number 性别 1
channel Number 渠道 0
deptId String 部门id 11w
mobile String 手机号 13212345432
employeeNo String 员工编号 00000003
idNo String 身份证号 421181199801012134
companyId Number 公司Id 26
employeeType Number 员工类型 0
brandId Number 品牌id 1302424855
name String 姓名 向南
id Number 员工id 65
position String 员工职位 前端工程师
thirdEmployeeNo String 三方员工编码 13212345432
age Number 年龄 20
status Number 员工状态 2
success Boolean 是否成功 true

请求参数示例

1).
{
   "employee":{
      "name":"向南",
      "nickName":"向南",
      "age":20,
      "idType":1,
      "idNo":"421181199801012134",
      "sex":1,
      "birthday":907171200,
      "mobile":"13212345432",	
      "entryDate":1601481600,
      "status":2,
      "employeeType":0,
      "deptId":"11w",
      "deptName":"研发部",	
      "thirdEmployeeNo":"13212345432",
      "position":"前端工程师"
    }
}

返回示例

1).
{
	"status": {
		"code": "0000000",
		"msg": "请求成功"
	},
	"result": {
		"data": {
			"birthday": 907171200,
			"deptName": "研发部",
			"idType": 1,
			"entryDate": 1601481600,
			"nickName": "向南",
			"sex": 1,
			"channel": 0,
			"deptId": "11w",
			"mobile": "13212345432",
			"employeeNo": "00000003",
			"idNo": "421181199801012134",
			"companyId": 26,
			"employeeType": 0,
			"brandId": 1302424855,
			"name": "向南",
			"id": 65,
			"position": "前端工程师",
			"thirdEmployeeNo": "13212345432",
			"age": 20,
			"status": 2
		}
	},
	"success": true
}

异常示例

API测试工具