api:dept_list

获取组织架构列表

该接口拉取企业的组织架构节点列表,不含员工帐号。拉取该接口时候,传入时间戳,服务器会传回该时间戳后发生过变更的组织架构节点。

请求地址

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

请求方式

get

请求样例

请求频率

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

请求参数

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

此请求还需要如下参数

字段名称 字段类型 字段说明
timestamp int 时间戳(上次拉取获得的时间戳,首次拉取或全量拉取
请填0)如果上次拉取后,没有发生变更的组织架构节点,
将不会包含在返回结果集合中

返回结果

{
  "ret": 0,
  "msg": "调用成功",
  "data": {
    "timestamp": 1460551018,
    "items": [
      {
        "dept_id": 1,
        "p_dept_id": 0,
        "dept_name": "Test_lucy_标准"
      },
      {
        "dept_id": 1136750599,
        "p_dept_id": 1,
        "dept_name": "总经理办公室"
      },
      {
        "dept_id": 1754170384,
        "p_dept_id": 1136750599,
        "dept_name": "秘书组"
      },
      {
        "dept_id": 74537005,
        "p_dept_id": 1136750599,
        "dept_name": "运营规划组"
      },
      {
        "dept_id": 869334989,
        "p_dept_id": 1,
        "dept_name": "客户服务部"
      },
      {
        "dept_id": 1808018519,
        "p_dept_id": 869334989,
        "dept_name": "秘书组"
      },
      {
        "dept_id": 1051829374,
        "p_dept_id": 1,
        "dept_name": "产品部"
      },
      {
        "dept_id": 1492884319,
        "p_dept_id": 1051829374,
        "dept_name": "产品中心"
      }
    ]
  }
}
字段名称 字段类型 字段说明
ret int 返回码:0 正常, >0 异常
msg string 如果ret不为0,会有相应的错误信息提示,UTF-8编码。
data array 数组

data格式:

字段名称 字段类型 字段说明
timestamp int 当前服务器时间戳
items array 组织架构节点对象的数组

items[0]单个节点对象格式:

字段名称 字段类型 字段说明
dept_id int 组织id
p_dept_id int 父组织id
dept_name string 组织名称

返回

api/dept_list.txt · 最后更改: 2016/04/22 17:09 (外部编辑)