创建员工

路径 /user/account/employee/create
版本号 1.0.4
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
companyId String 公司id
companyName String 公司名
phone String 手机号
email String 邮箱地址
name String 昵称
avatarUrl String 头像地址
creater String 创建者
isMainAccount Int 是否是主账号(0表示非主账号,1表示是主账号)
dingCorpId String 该员工在钉钉企业中的的公司id
dingUserId String 该员工在钉钉企业中的员工id
extraInfo String 扩展字段(用于业务方存储自己的业务字段)
password String Hello12345
openId String 第三方openId
outPlatformType Int 第三方账号类型
loginName String 登陆账号名
accountId String 账号id
mainIdentityId String 主账号的身份id

返回数据

名称 类型 示例值 描述
code Int

响应码, 200: 成功

message String

错误消息

localizedMsg String

本地语言错误消息

data JSON

响应结果

phone String

手机号

email String

邮箱地址

companyId String

公司id

companyName String

公司名称

name String

用户名

creater String

创建者

avatarUrl String

头像地址

email String

邮箱地址

isMainAccount Int

是否是主账号(0表示非主账号,1表示是主账号)

identityId String

统一身份id

thirdPartyId String

外部平台id

dingCorpId String

该员工在钉钉企业中的的公司id

dingUserId String

该员工在钉钉企业中的员工id

extraInfo String

扩展字段(用于业务方存储自己的业务字段)

accountId String

账号id

mainIdentityId String

主账号对应的身份id

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.4"
	},
	"params":{
		"companyId": "value0",
		"companyName": "value1",
		"phone": "value2",
		"email": "value3",
		"name": "value4",
		"avatarUrl": "value5",
		"creater": "value6",
		"isMainAccount": "value7",
		"dingCorpId": "value8",
		"dingUserId": "value9",
		"extraInfo": "value10",
		"password": "value11",
		"openId": "value12",
		"outPlatformType": "value13",
		"loginName": "value14",
		"accountId": "value15",
		"mainIdentityId": "value16"
	}
}

正常返回示例

JSON 格式

{
  "id": "8d1a665e-ce92-45bf-add8-99d2e81814f3",
  "code": 200,
  "message": null,
  "localizedMsg": null,
  "data": {
    "companyId": "68F351FCA7DC43D69AB4388F4D7EC64A",
    "companyName": "浙江天猫技术有限公司",
    "creater": "iotoc_test",
    "phone": "13877776666",
    "identityId": "50ce68a91603a03246e5756b07776bd7e29b2479",
    "name": "测试",
    "email": "abc@abc.com",
    "password":"Hello1234",
    "avatarUrl": "http://www.abc.com/abc.jpg",
    "isMainAccount":0,
    "mainIdentityId":"53324gdh544500332424458djj7343434",
    "thirdPartyId":"11223345",
    "accountId":"500332424458djj7343434",
    "dingCorpId":"ding500323412345GGDGRG334",
    "dingUserId":"32344234",
    "extraInfo":"{\"aa\":\"bb\"}",
    "accountId":"ding500323412dddddddGRG334"
  }
}

异常返回示例

JSON 格式

{
  "id": "8d1a665e-ce92-45bf-add8-99d2e81814f3",
  "code": 2441,
  "message": "employee is already existed",
  "localizedMsg": null,
  "data":null
}

错误码

HttpCode 错误码 错误信息 描述
500 500 Internal Error Internal Error
503 503 Service Unavailable Service Unavailable
403 403 Request Limited Request Limited
401 401 Empty Signature Empty Signature
400 400 Request Format Error Request Format Error
200 20003 Find Backend Error Find Backend Error
200 20004 Backend Service Error Backend Service Error
200 20055 Backend Service Invalid Request Format Error
200 20056 Hsf Invoke Timeout Hsf Invoke Timeout
200 401 Request Authorized Error Request Authorized Error
200 403 Request Forbidden Request Forbidden
200 500 Server Error Server Error
200 2402 iotToken not exist iottoken不存在
200 2402 iotToken not exist
200 460 iotToken is blank iotToken为空
200 2402 iottoken invalid iottoken已经失效
200 2401 refreshToken invalid refreshToken已经失效
200 2402 iotToken not exist
200 403 request forbidden. 请求被禁止
200 2477 import thirdaccount failed 导入三方账号失败
200 460 thirdAccountMetaList is blank 三方账号列表为空
200 403 request forbidden. 请求被禁止
200 403 request forbidden. 请求被禁止
200 460 request parameter error. 入参不正确
200 460 identityIds need between 1-50 入参错误
200 403 request forbidden. 请求被禁止
200 2453 app not exist appkey不存在
200 2405 identity is not existed 统一身份id不存在
200 2407 auth identity exception 不存在相应的openId
200 403 request forbidden. 请求被禁止
200 401 app key tenant id not match appkey所属租户与统一身份ID不一致
200 2453 app not exist appKey不存在
200 460 request parameter error. 请求参数错误
200 401 request auth error. appKey与统一身份ID对应的租户不同
200 2453 app not exist appKey对应的应用不存在
200 401 app key tenant id not match appkey所属租户与统一身份ID不一致
200 2453 app not exist appKey不存在
200 460 request parameter error. 请求参数错误
200 401 app key tenant id not match app key tenant id not match
200 2453 app not exist appkey对应的应用不存在
200 460 companyId or phone is blank 入参中公司id和手机号不全
200 2441 employee is already existed 该员工已经存在
200 403 request forbidden. 请求被禁止
200 460 request parameter error 账号不存在
200 460 pageSize should between 1-100 每页的数量在1-100之间
200 2405 employee is not existed 身份id不存在
200 2411 oldpassword check faild 老密码校验不通过
200 403 request forbidden. 请求被禁止
200 403 request forbidden 访问被禁止
200 460 dingdingbind employee not exist 请求参数错误
200 2442 employee is not exist 未找到绑定的员工信息
200 2441 employee is already existed 该员工已经存在