查询企业帐号状态

GET

/v1.0/contact/orgAccounts/status

调用本接口，查询某企业帐号的启用状态。

如下图所示，企业账号可分为正常和已停用两种状态。

权限

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

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

HttpCode	错误码	错误信息	说明
400	invalid.param	无效参数	无效参数
400	user.not.exist	用户不存在	用户不存在
400	exclusive.account.only	只能操作归属该组织的专属帐号	只能操作归属该组织的专属帐号
500	system.busy	系统繁忙	系统繁忙

Query 参数

Header 参数

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/v1.0/contact/orgAccounts/status?userId=String' \
--header 'x-acs-dingtalk-access-token;'

🟢200成功

application/json

Body

示例

{
    "disable": true
}

修改于 2025-09-08 06:28:05