获取企业内部应用微应用的可使用范围

调用本接口，获取企业内部应用微应用设置的可使用范围信息。

接口功能介绍

例如，企业开发者后台有个名称为测试微应用的应用，当前的可使用范围设置如下图所示，包含测试部门1、测试部门2、员工小钉1和员工小钉2。

调用本接口可以获取到该应用的可使用范围设置，获取到员工小钉1和员工小钉2的userId以及测试部门1和测试部门2的部门ID。

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	管理微应用的权限	API Explorer
第三方企业应用	暂不支持	管理微应用的权限	暂不支持
第三方个人应用	暂不支持	管理微应用的权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidParam	参数错误: %s	参数错误
500	systemError	系统繁忙	系统繁忙

{ "result": { "userIds": [ "string" ], "deptIds": [ 0 ], "roleIds": [ 0 ], "onlyAdminVisible": true } }

请求参数

Path 参数

agentId

string

必需

应用agentId，参考基础概念-AgentId。

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

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

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

返回响应

🟢200成功

application/json

Body

result

object

可使用范围结果。

必需

userIds

array[string]

用户userId。

必需

deptIds

array[integer]

部门ID。

必需

roleIds

array[integer]

角色ID。

必需

onlyAdminVisible

boolean

必需

是否仅管理员可使用。 true：userIds、deptIds和roleIds字段值为空。 false：userIds、deptIds和roleIds字段有对应值。

获取企业内部应用微应用的可使用范围

接口功能介绍#

权限#

错误码#

请求参数

返回响应

接口功能介绍

权限

错误码