api:user_list

获取员工基本资料列表

请求地址

https://openapi.b.qq.com/api/user/list

请求方式

get

请求样例

请求频率

6次/分钟(详见频率限制)

请求参数

所有向企业QQ发起的请求均包含该公共参数

此请求还需要如下参数

字段名称 字段类型 字段说明
timestamp int 时间戳(上次拉取获得的时间戳,首次拉取或全量拉取请传0)

返回结果

{
  "ret": 0,
  "msg": "调用成功",
  "data": {
    "timestamp": 1460549812,
    "items": [
      {
        "open_id": "0f09375d4e73599bcfa665d195fa7697",
        "gender": 1,
        "account": "test",
        "realname": "test",
        "title": ":",
        "p_dept_id": [
          1754170384,
          1
        ],
        "mobile": 0,
        "hidden": 0,
        "p_open_id": "",
        "role_id": 0
      }
    ]
  }
}

返回JSON格式数据:

字段名称 字段类型 字段说明
ret int 返回码:0 正常, >0 异常
msg string 如果ret不为0,会有相应的错误信息提示,UTF-8编码。
data object JS对象格式数据

data格式:

字段名称 字段类型 字段说明
timestamp int 当前服务器时间戳
items array 员工对象的数组

items[0]对象格式:

字段名称 字段类型 字段说明
open_id string 用户id
gender int 性别(1男2女)
account string 帐号
realname string 姓名
p_dept_id array 父组织id,单个或者多个
mobile int 0:无手机号
1: 有手机号
hidden int 0:不隐藏
1:隐藏
(需要第三方应用根据该状态来显示还是隐藏该成员),
如果一个成员处于隐藏状态,他可以看到所有的成员,
否则只能看到非隐藏的成员
p_open_id string 直接上司的open_id
role_id int 0: 企业管理员
1: 系统管理员
2: 信息管理员
4: 普通员工
其他: 自定义角色

返回

api/user_list.txt · 最后更改: 2016/04/22 16:55 (外部编辑)