查询通讯录数据

企业门户APP

查询通讯录数据

基地址：baseAddress

通过员工工号查询详情

请求方式：

post

请求地址

baseAddress/hipspfm/hippius/v1/sync/employee/listByEmployeeNum?access_token=ACCESS_TOKEN

参数：

["7974000","7975000"]

参数说明：数组参数

返回结果：

[
    {
        "imageUrl": "https://hmhprod-public.bj.bcebos.com/0/b8a83481647745e39163ac5e562a3e96@1585710906220.png",
        "name": "测试",
        "email": "",
        "mobile": "+86-1316290000",
        "gender": 1,
        "employeeNum": "7974000",
        "enabledFlag": 1,
        "list": [
            {
                "primaryPositionFlag": 1,
                "unitCode": "300482",
                "positionCode": "20101158"
            }
        ],
        "propertyInfoDTOS": []
    }
]

参数	说明	参考值
name	姓名
imageUrl	头像
mobile	手机号
gender	性别	1男0女
employeeNum	工号
enabledFlag	是否有效	1有效0无效
list	岗位部门
propertyInfoDTOS	额外字段值

list内容：

参数	说明	参考值
primaryPositionFlag	是否主岗	1是0否
unitCode	部门编码
positionCode	岗位编码

propertyInfoDTOS 内容：

参数	说明	参考值
propertyKey	额外字段key	1是0否
infoName	额外字段值

通过部门编码查询部门下的员工详情

请求方式：

get

请求地址

baseAddress/hipspfm/hippius/v1/sync/employee/listByUnitCode?unitCode=ss&access_token=ACCESS_TOKEN

参数：

unitCode

参数说明：

参数	含义	说明
unitCode	部门编码	如果为空则查询跟部门下的所有员工

返回结果：

[
    {
        "imageUrl": "https://hmhprod-public.bj.bcebos.com/0/b8a83481647745e39163ac5e562a3e96@1585710906220.png",
        "name": "测试",
        "email": "",
        "mobile": "+86-1316290000",
        "gender": 1,
        "employeeNum": "7974000",
        "enabledFlag": 1,
        "list": [
            {
                "primaryPositionFlag": 1,
                "unitCode": "300482",
                "positionCode": "20101158"
            }
        ],
        "propertyInfoDTOS": []
    }
]

结果说明：

参数	说明	参考值
name	姓名
imageUrl	头像
mobile	手机号
gender	性别	1男0女
employeeNum	工号
enabledFlag	是否有效	1有效0无效
list	岗位部门
propertyInfoDTOS	额外字段值

list内容：

参数	说明	参考值
primaryPositionFlag	是否主岗	1是0否
unitCode	部门编码
positionCode	岗位编码

propertyInfoDTOS 内容：

参数	说明	参考值
propertyKey	额外字段key	1是0否
infoName	额外字段值

通过部门编码查询下级部门

请求方式：

get

请求地址

baseAddress/hipspfm//hippius/v1/sync/dept/list?unitCode=ss&access_token=ACCESS_TOKEN

参数：

unitCode

参数说明：

参数	含义	说明
unitCode	部门编码	如果为空则查询跟部门下的所有员工

返回结果：


[
    {
        "children":[
            {
                "unitId":6282,
                "unitCode":"CES",
                "unitName":"ces",
                "parentUnitId":2,
                "enabledFlag":1,
                "orderSeq":1,
                "unitTlDTOS":[
                    {
                        "unitId":null,
                        "lang":"zh_CN",
                        "unitName":"ces"
                    },
                    {
                        "unitId":null,
                        "lang":"ko_KR",
                        "unitName":"ces"
                    },
                    {
                        "unitId":null,
                        "lang":"ja_JP",
                        "unitName":"ces"
                    },
                    {
                        "unitId":null,
                        "lang":"en_US",
                        "unitName":"ces"
                    }
                ]
            }
        ],
        "unitId":2,
        "unitCode":"HIPPIU0001",
        "unitName":"hzero测试",
        "enabledFlag":1,
        "orderSeq":1,
        "unitTlDTOS":[
            {
                "unitId":null,
                "lang":"zh_CN",
                "unitName":"hzero测试"
            },
            {
                "unitId":null,
                "lang":"en_US",
                "unitName":"hzero测试"
            }
        ],
        "childrenCount":1
    }
]

结果说明：

参数	说明	参考值
unitId	部门ID
unitCode	部门编码
unitName	部门名称
orderSeq	顺序
enabledFlag	是否有效	1有效0无效
unitTlDTOS	部门多语言
childrenCount	子部门数量
children	子部门内容

unitTlDTOS内容

参数	说明	参考值
lang	语言	zh_CN
unitName	部门名称