批量通过伙伴组织的加入申请

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，批量通过伙伴组织加入上下游组织申请。

例如，上下游组织的通讯录目前没有任何伙伴组织加入，如下图所示。

上下游组织收到两条加入申请，分别为关联组织和体验组织，申请信息如下图所示。

调用本接口可同时同意这两条加入上下游组织的申请。接口调用成功后，上下游组织的通讯录新增了关联组织和体验组织，如下图所示。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	通讯录合作空间写权限	API Explorer
第三方企业应用	支持	通讯录合作空间写权限	API Explorer
第三方个人应用	暂不支持	通讯录合作空间写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	parameter.blank	参数为空	非法的系统参数
400	parameter.error	单次操作不能超过10个	单次操作不能超过10个
500	system.error	操作失败	操作失败

curl --location --request POST 'https://api.dingtalk.com/v1.0/contact/cooperateCorps/unionApplications/approve' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw '[ { "branchCorpId" : "String", "unionRootName" : "String", "linkDeptId" : Long } ]'

请求参数

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。

第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

Body 参数application/json

array of:

branchCorpId

string

可选

unionRootName

string

可选

示例

批量通过伙伴组织的加入申请

权限#

错误码#

请求参数

返回响应

权限

错误码