获取已加入或正在申请加入上下游组织的组织和个人信息旧版SDK

更新于 2023-01-18

接口调用量说明使用当前 API 接口会消耗每月计量 API 调用额度，请登录开发者后台-资源管理查看企业所有的用量权益。如您已经收到用量预警，或调用额度无法满足使用，您可以购买应用开发增购包（独立购）提升当月调用总额度。

调用本接口通过上下游组织组织ID获取加入或申请加入上下游组织的组织和个人信息。

重要

上下游组织是基于普通组织底层构建的业务类型，通讯录相关API都可以使用。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/union/cooperate/info/list

名称

类型

是否必填

示例值

描述

access_token

String

是

Be31xxxx

调用该接口的应用凭证。

名称

类型

是否必填

示例值

描述

status

Number

是

加入空间的状态：

名称	类型	示例值	描述
result	OpenCooperateUnionVo[]		加入或申请加入的空间信息。
auth_level	Number	1	加入企业认证等级： 0：未认证 1：高级认证 2：中级认证 3：初级认证
userids	String[]	["036063186819979769","030651132420130642"]	单独加入的员工。所在部门不需要加入的情况，直接选择的几个员工。
dept_ids	Number[]	[83945234,85253077,84942289]	加入的部门列表。部门下的员工会全部加入。
union_type	Number	2	加入的方式： 1：全部加入(不需要选择部门和员工) 2：部分加入
dept_name	String	测试企业	挂载部门名称(在上下游组织中的架构属性)，不设置默认是加入企业的名称。
dept_id	Number	13333	挂载部门ID(在上下游组织中的架构属性)。
union_org_name	String	测试企业	加入企业的企业名称。
union_corp_id	String	"test"	加入企业的企业corpId。
success	Boolean	true	调用是否成功。
errcode	Number	0	返回码。
errmsg	String	ok	返回码描述。