api:dept_info

单个或者批量获取组织架构节点的信息

该节点用于单个或者批量获取组织架构节点的信息,主要为了第三方接入的时候,更新组织架构信息提供方便。

请求地址

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

请求方式

get

请求样例

请求频率

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

请求参数

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

此请求还需要如下参数

字段名称 字段类型 字段说明
dept_ids string 用英文逗号分隔的dept_id的列表

返回结果

字段名称 字段类型 字段说明
ret int 返回码:0 正常, >0 异常
msg string 如果ret不为0,会有相应的错误信息提示,UTF-8编码。
data array javascript 对象,以dept_id为键,以组织节点的基本信息对象为值

组织节点对象格式:

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

正确的返回值格式范例(注意,实际返回时,汉字是经过UTF8编码的):

{
    "ret": 0,
    "msg": "调用成功",
    "data": {
        "74537005": {
            "dept_id": 74537005,
            "p_dept_id": 1136750599,
            "dept_name": "\u8fd0\u8425\u89c4\u5212\u7ec4"
        },
        "145700027": {
            "dept_id": 145700027,
            "p_dept_id": 1358976803,
            "dept_name": "\u8fd0\u8425\u89c4\u5212\u7ec4"
        },
        "322087292": {
            "dept_id": 322087292,
            "p_dept_id": 1358976803,
            "dept_name": "english dept name"
        }
    }
}

返回

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