获取可打标部门列表
GET
/v1.0/exclusive/partnerDepartments最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取可打标部门的信息,包括部门人数、ID、伙伴编码和伙伴类型等。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 伙伴钉部门信息读权限 | API Explorer |
第三方企业应用 | 支持 | 伙伴钉部门信息读权限 | API Explorer |
第三方个人应用 | 暂不支持 | 伙伴钉部门信息读权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | param.illegal | 参数不合法 | 参数不合法 |
500 | system.busy | 系统内部错误 | 系统内部错误 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
object {0}
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
array [object {10}]
可选
伙伴钉可打标部门列表。
deptId
string
部门ID。
superDeptId
string
父部门ID。
deptName
string
部门名称。
memberCount
integer
部门人数。
partnerNum
string
部门伙伴编码。
partnerLabelVOLevel1
object
部门一级伙伴类型。
partnerLabelVOLevel2
object
部门二级伙伴类型。
partnerLabelVOLevel3
object
部门三级伙伴类型。
partnerLabelVOLevel4
object
部门四级伙伴类型。
partnerLabelVOLevel5
object
部门五级伙伴类型。
示例
{
"data": [
{
"deptId": "string",
"superDeptId": "string",
"deptName": "string",
"memberCount": 0,
"partnerNum": "string",
"partnerLabelVOLevel1": {
"labelId": 0,
"labelName": "string",
"levelNum": 0
},
"partnerLabelVOLevel2": {
"labelId": 0,
"labelName": "string",
"levelNum": 0
},
"partnerLabelVOLevel3": {
"labelId": 0,
"labelName": "string",
"levelNum": 0
},
"partnerLabelVOLevel4": {
"labelId": 0,
"labelName": "string",
"levelNum": 0
},
"partnerLabelVOLevel5": {
"labelId": 0,
"labelName": "string",
"levelNum": 0
}
}
]
}
最后修改时间: 2 年前