首页 > 开发指南 > 通讯录管理
获取部门列表
更新时间: 2021-12-08 10:46:43

通讯录管理

通过通信录管理接口,你可以实现企业HR系统做与珍岛开放平台之间的部门和人员信息同步。

获取部门列表

请求说明

请求方式:post+application/json 方式

请求路径:https://open.71360.com/cgi/department/list

参数说明

参数参数类型必须说明
corpAccessTokenString企业应用访问公司合法性凭证
corpIdString开放平台公司帐号

请求包结构体示例:

{
    "corpAccessToken": "CORP_ACCESS_TOKEN",
    "corpId": "CORP_ID"
}

返回说明

参数必须说明
errorCode返回码
errorMessage对返回码的文本描述内容
departments二级对象
id
部门ID
name
部门名称
parentId
父部门ID,根部门ID为0,其它部门Id为非负整数
isStop是否停用(true表示停用,false表示正常)
order
部门排序,序号越小,排序越靠前。最小值为1

a) 正确的JSON返回结果示例:

{
    "errorCode": 0,
    "errorMessage": "success",
    "departments": [
        {
            "id": 11,
            "name": "事业部",
            "parentId": 1,
            "order": 1
        },
        {
            "id": 12,
            "name": "财务部",
            "parentId": 1,
            "order": 2
        }
    ]
}

b) 错误的JSON返回示例:

{
    "errorCode": 10001,
    "errorMessage": "the parameter appId is missing"
}