根据userId查询人员的标签信息
更新于 2023-01-18调用本接口查询上下游组织内人员的标签信息。
本接口目前仅支持专属钉钉企业调用，如何申请开通专属钉钉，请参考专属钉钉开通流程。
例如，上下游测试组织内有个合作伙伴为关联组织。调用本接口，可获取关联组织根部门下的某员工信息。如下图所示，该员工所在的部门名称为关联组织，伙伴编码为partner1，一级伙伴类型为供应商。
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 伙伴钉部门信息读权限 | API Explorer |
| 第三方企业应用 | 支持 | 伙伴钉部门信息读权限 | API Explorer |
| 第三方个人应用 | 暂不支持 | 伙伴钉部门信息读权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Path参数
返回参数
名称 | 类型 | 描述 |
|---|---|---|
partnerDeptList | Array | 员工所在的部门列表。 |
title | String | 部门名称。 |
value | String | 部门ID。 |
memberCount | Long | 成员数。 |
partnerNum | String | 伙伴编码。 |
partnerLabelModelLevel1 | Object | 一级伙伴信息。 |
labelId | Long | 一级伙伴标签ID。 |
labelname | String | 一级伙伴类型。 |
partnerLabelList | Array | 伙伴类型下的角色列表。 |
id | Long | 伙伴标签下的角色ID。 |
name | String | 伙伴标签下的角色名称。 |
userId | String | 员工userId。 说明
如果partnerLabelList为空，该字段返回为空。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | param.not.found | 参数不能为空 | 参数不能为空 |
500 | user.not.found | 该员工不在企业中 | 该员工不在企业中 |
500 | hava.no.auth | 该员工无企业权限 | 该员工无企业权限 |
