根据迁移后的unionId查询原unionId新版SDK

更新于 2023-09-07

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

调用本接口，根据迁移后的unionId查询原unionId。

接口功能介绍

普通帐号迁移为企业帐号后，可调用本接口根据迁移后企业账号的unionId查询原普通账号的unionId。

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	通讯录企业账号迁移数据读权限	API Explorer
第三方企业应用	支持	通讯录企业账号迁移数据读权限	API Explorer
第三方个人应用	暂不支持	通讯录企业账号迁移数据读权限	暂不支持

请求方法

Header参数

名称	类型	是否必填	描述
x-acs-dingtalk-access-token	String	是	调用该接口的访问凭证。企业内部应用，调用获取企业内部应用的accessToken接口获取。第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

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

Query参数

名称	类型	是否必填	描述
migrationUnionId	String	是	迁移后企业账号的unionId。企业内部应用，调用查询企业帐号用户详情接口获得unionid参数值。第三方企业应用，调用查询企业帐号用户详情接口获得unionid参数值。

名称

类型

是否必填

描述

migrationUnionId

String

是

迁移后企业账号的unionId。

企业内部应用，调用查询企业帐号用户详情接口获得unionid参数值。
第三方企业应用，调用查询企业帐号用户详情接口获得unionid参数值。

返回参数

名称	类型	描述
unionId	String	原普通账号的unionId。

示例

请求示例

HTTP

Java

Python

PHP

Node.js

C++

返回示例

错误码

HttpCode	错误码	错误信息	说明
400	invalid.param	无效参数	无效参数
400	invalid.userid	找不到该用户	找不到该用户
400	illegal.migration.unionId	非法的migrationUnionId	非法的migrationUnionId
500	system.busy	系统繁忙	系统繁忙

这篇文档是否有帮助？

本页内容