获取员工详情

获取员工详情。调用此接口需购买基础席位。

返回响应

🟢200成功

application/json

Body

errcode

integer

可选

状态码，0为正常，非0代表错误。业务错误码下述，全局错误码见全局错误码

errmsg

string

可选

错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

staff

object (Staff)

员工数据

可选

string

员工id

可选

alias

string

员工别名

可选

name

string

员工名称

可选

english_name

string | null

员工英文名称

可选

status

integer

可选

激活状态。1=已激活，2=已禁用，4=未激活。已激活代表已激活企业微信或已关注微工作台（原企业号）。未激活代表既未激活企业微信又未关注微工作台（原企业号）。如果一个员工被移除了企业（比如离职），也会是状态4

address

string | null

地址

可选

avatar

string

员工头像

可选

created_at

integer

可选

数据创建时间（微伴系统内时间）

departments

string

可选

员工所在的所有部门，格式为"根目录/子目录1/子目录2/子目录3"，比如"未闻花名测试部门/部门1/小组1"，如果存在多个部门将会以 ; 分隔

string

邮箱

可选

extattr

object | null

可选

员工扩展属性，由企业微信提供，具体见企业微信对应文档

mobile

string

手机号码

可选

moment_address

string | null

企业朋友圈地址

可选

oa_authorized

boolean

可选

是否在第三方应用授权

position

string

职位信息

可选

qr_code

string

可选

员工个人二维码，扫描可添加为外部联系人

telephone

string

座机

可选

external_contact_able

boolean

可选

是否配置了客户联系功能（既是否属于客服）

external_position

string | null

可选

对外职务。第三方仅通讯录应用可获取

external_profile

object | null

可选

员工自定义展示信息，可以有多个字段和多种类型，包括文本，网页和小程序，仅当联系人类型是企业微信用户时/有此字段，字段详情见企业微信对应文档

gender

integer

可选

员工性别。0-未知 1-男性 2-女性

ia_authorized

boolean

是否在自建应用授权

可选

ma_authorized

boolean

是否在消息存档授权

可选

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "staff": {
    "id": "zhangsan",
    "alias": "小张",
    "name": "张三",
    "english_name": "San Zhang",
    "status": 1,
    "address": "xxx",
    "avatar": "http://wework.qpic.cn/bizmail/6orVYFdOtxfZXkvvYWRWL83jpYATML7JcbDnYCB8PftMfuLwqzD9bQ/",
    "created_at": 1578942639,
    "departments": "未闻花名测试部门/部门1/小组1",
    "email": "xxx",
    "extattr": {
      "attrs": []
    },
    "mobile": "13600000000",
    "moment_address": "http://wtjpnamxad.devclient.weibanzhushou.com/mobile/moment?code=8M5780D883C9E5D071E9C737C7406C9FCDC0DC6A75CBEF5819A830A9982D241DF098812041B95019BC042CA4DF019C46",
    "oa_authorized": true,
    "position": "xxxx",
    "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vc9d8f940363c17952",
    "telephone": "021-10000000",
    "external_contact_able": true,
    "external_position": null,
    "external_profile": {
      "external_attr": [],
      "external_corp_name": ""
    },
    "gender": 1,
    "ia_authorized": true,
    "ma_authorized": true
  }
}

🟢200正常返回

请求参数

示例代码

返回响应