支持接口批量导入企业员工信息到绿色公务企业管理后台,导入后台的企业员工在后台关联企业用车规则后,支持使用绿色公务APP叫车。
请求地址: /v2/common/importCompanyMembers
服务协议: HTTP/POST
Content-Type: application/x-www-form-urlencoded
请求参数:
参数名 | 类型 | 必选 | 说明 |
---|---|---|---|
client_id | string | Y | 申请的client_id |
timestamp | long | Y | 时间戳 |
sign | string | Y | 参数签名 |
members | string | Y | 员工信息数组的json串, 数量限制, 暂定50, 例如:[{"phone":"123","name":"abc"},{"phone":"456","name":"efg"}] |
响应data参数:
参数名称 | 类型 | 必有 | 说明 |
---|---|---|---|
successMembers | string | Y | 导入成功的员工手机号列表 |
failMembers | string | Y | 导入失败的员工手机号列表 |
结果示例:
{
"code": 200,
"success": true,
"data":
{
"successMembers": ["1861111111","1861111111"],
"failMembers": ["1861111111","1861111111"]
}
}
批量新增或更新员工信息/用车规则,该接口适用于支使用绿色公务APP叫车、免登企业H5叫车,单次最多处理50个员工 绿色公务APP叫车以phone为唯一标识 免登企业H5叫车以extUserId为唯一标识(API+H5用车进行员工创建时必传该字段)
请求地址: /v2/common/importCompanyMembersV2
服务协议: HTTP/POST
Content-Type: application/x-www-form-urlencoded
请求参数:
参数名 | 类型 | 必选 | 说明 |
---|---|---|---|
client_id | string | Y | 申请的client_id |
timestamp | long | Y | 时间戳 |
sign | string | Y | 参数签名 |
member_list | string | Y | 员工信息json列表,参数格式见下表 |
导入员工信息(member)参数
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
name | string | Y | 姓名 |
phone | string | N | 手机号(曹操企业版app使用方必传),如果 extUserId与phone都传入,以extUserId为准 |
extUserId | string | N | 第三方用户ID(h5接入时必传),如果 extUserId与phone都传入,以extUserId为准 |
outEmpId | string | N | 员工ID |
deptName | string | N | 部门名 |
cityCode | string | N | 常驻城市(从2.1城市开通服务查询获取城市code),支持多个,最多5个 ,英文逗号分隔 |
ruleIds | string | N | 规则ID:支持多个,同规则场景只支持传入1个规则 ,英文逗号分隔 |
响应data参数:
参数名称 | 类型 | 必有 | 说明 |
---|---|---|---|
successMembers.phone | string | N | 导入成功员工手机号 |
successMembers.extUserId | string | N | 导入成功员工第三方用户Id |
failMembers.phone | string | N | 导入失败员工手机号 |
failMembers.extUserId | string | N | 导入失败员工第三方用户Id |
failMembers.failReason | string | N | 导入失败原因 |
结果示例:
{
"code": 200,
"data": {
"failMembers": [
{
"phone": "131abcdefgh",
"extUserId": "",
"failReason": "手机号格式不对!"
}
],
"successMembers": [
{
"phone": "138XXXXXXXX",
"extUserId": "ext_user_0"
}
]
},
"message": "成功",
}