通过员工昵称查询

POST

https://open.fxiaoke.com/cgi/user/getByNickName

该接口返回值与手机号查询员工一致。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.fxiaoke.com/cgi/user/getByNickName' \
--header 'Content-Type: application/json' \
--data-raw '{    "corpAccessToken": ,    "corpId": {{corpId}},    "nickName": "xiaom"}'

响应示例

{
    "empList": [
        {
            "enterpriseId": 74652,
            "openUserId": "FSUID_29E5A988B0A54AD400C3D5861E18C683",
            "account": "xiaom",
            "fullName": "小明",
            "name": "xiaom",
            "status": "NORMAL",
            "mobile": "18211565695",
            "leaderId": "FSUID_C6384C8A5942F92C691BC1339D367877",
            "telephone": "",
            "role": "UNKNOWN",
            "post": "",
            "qq": "",
            "email": "",
            "gender": "M",
            "profileImage": "",
            "description": "",
            "weixin": "",
            "msn": "",
            "extensionNumber": "",
            "mobileSetting": {
                "mobileStatus": "PUBLIC",
                "departmentIds": [],
                "employeeIds": []
            },
            "workingState": "",
            "isActive": true,
            "mainDepartmentIds": [
                1000
            ],
            "departmentIds": [
                1000
            ],
            "departmentAsteriskIds": [],
            "employeeAsteriskIds": [],
            "birthDate": "",
            "hireDate": "2019-02-01",
            "empNum": "",
            "startWorkDate": "",
            "stopTime": 0,
            "createTime": 1557819347900,
            "updateTime": 1585122983800,
            "nameSpell": "xiaom",
            "nameOrder": "X#0058#0055#0043#0048#0041#004F"
        }
    ],
    "errorCode": 0,
    "errorMessage": "success",
    "errorDescription": "成功"
}

请求参数

Body 参数application/json

corpAccessToken

string

必需

企业应用访问公司合法性凭证

corpId

string

必需

开放平台公司帐号

nickName

string

员工昵称

必需

示例

返回响应

🟢200成功

application/json

Body

empList

array [object {35}]

返回的员工列表

必需

enterpriseId

integer

可选

openUserId

string

可选

account

string

可选

fullName

string

可选

name

string

可选

status

string

可选

mobile

string

可选

leaderId

string

可选

telephone

string

可选

role

string

可选

post

string

可选

string

可选

string

可选

gender

string

可选

profileImage

string

可选

description

string

可选

weixin

string

可选

msn

string

可选

extensionNumber

string

可选

mobileSetting

object

可选

workingState

string

可选

isActive

boolean

可选

mainDepartmentIds

array[integer]

可选

departmentIds

array[integer]

可选

departmentAsteriskIds

array[string]

可选

employeeAsteriskIds

array[string]

可选

birthDate

string

可选

hireDate

string

可选

empNum

string

可选

startWorkDate

string

可选

stopTime

integer

可选

createTime

integer

可选

updateTime

integer

可选

nameSpell

string

可选

nameOrder

string

可选

errorCode

integer

返回码

必需

errorMessage

string

必需

对返回码的文本描述内容

errorDescription

string

必需

修改于 2022-01-04 09:12:55

根据手机号查询员工