Application Portal API¶
EnOS Application Portal 是基于 EnOS 的应用统一登录门户。你可以通过 Application Portal 服务 API 获取到用户、资产、应用相关的信息，方便在 EnOS Application Portal 上进行权限配置。
有关 Application Portal 的详细信息，参见 有关 Application Portal。
有关 EnOS API 的详细信息，参见 有关 EnOS API。
学习如何调用 EnOS API，参见 EnOS API 快速入门。
API¶
身份认证¶
操作名称 |
描述 |
适用于 EnOS Cloud |
适用于 EnOS Edge |
|---|---|---|---|
获取 Access Token 所对应的当前登录用户的相关信息 |
√ |
√ |
|
登录账号 |
√ |
√ |
|
通过单点登录（SSO）的授权码登录 |
√ |
× |
|
登出账号 |
√ |
√ |
|
使用 Refresh Token 请求一个新的 Access Token |
√ |
√ |
|
撤销用户所有的 Refresh Token |
√ |
√ |
用户与组织¶
操作名称 |
描述 |
适用于 EnOS Cloud |
适用于 EnOS Edge |
|---|---|---|---|
用户在登录后选择需要进入使用的组织 |
√ |
√ |
|
不登录 Application Portal 的状态下创建用户并为该用户分配组织 |
√ |
× |
|
不登录 Application Portal 的状态下把一批用户添加进组织 |
√ |
× |
|
获取当前账号权限下可管理的所有用户列表 |
√ |
√ |
|
根据 Access Token 列出当前用户所在的组织列表 |
√ |
√ |
|
获取指定组织下可使用语言的列表 |
√ |
√ |
|
不登录 Application Portal 的状态下授权应用获取指定组织下所有用户列表 |
√ |
√ |
|
获取组织内所有角色 |
√ |
√ |
|
根据应用的 |
√ |
√ |
|
获取当前用户的信息 |
√ |
√ |
|
通过用户邮箱地址获取用户所在的域信息 |
√ |
√ |
|
获取用户所分配的组织结构节点 |
√ |
√ |
|
获取用户被分配的角色 |
√ |
√ |
|
获取用户在当前应用下授权的权限点 |
√ |
× |
|
根据用户邮箱、账号和域、或电话号码和电话区号获取用户的基本信息如用户 ID 等 |
√ |
× |
|
不登录 Application Portal 的状态下获取一批用户的资产权限 |
√ |
× |
|
不登录 Application Portal 的状态下获取一批用户的角色 |
√ |
× |
|
不登录 Application Portal 的状态下获取一批用户的组织结构 |
√ |
× |
|
不登录 Application Portal 的状态下获取一批用户的用户组 |
√ |
× |
|
不登录 Application Portal 的状态下给用户分配组织结构 |
√ |
× |
|
不登录 Application Portal 的状态下给用户分配角色 |
√ |
× |
|
不登录 Application Portal 的状态下给用户分配用户组 |
√ |
× |
|
不登录 Application Portal 的状态下给用户移除组织结构 |
√ |
× |
|
不登录 Application Portal 的状态下给用户移除角色 |
√ |
× |
|
不登录 Application Portal 的状态下给用户移除用户组 |
√ |
× |
|
不登录 Application Portal 的状态下把一个用户移出一个组织 |
√ |
× |
资产¶
操作名称 |
描述 |
适用于 EnOS Cloud |
适用于 EnOS Edge |
|---|---|---|---|
将在 EnOS 平台上新建的资产授权给创建人 |
√ |
√ |
|
查看是否有资产的权限 |
√ |
√ |
|
获取当前用户在某个应用下有权限的所有资产 |
√ |
√ |
|
获取指定用户在指定组织下有权限的所有资产 |
√ |
√ |
|
获取资产所在的组织结构的上游组织结构 |
√ |
√ |
|
获取用户在组织结构上的资产 |
√ |
√ |
|
将在 EnOS 平台上标有指定标签的资产同步到 Application Portal |
√ |
√ |
|
获取对某一资产有权限的用户列表 |
√ |
√ |
应用¶
操作名称 |
描述 |
适用于 EnOS Cloud |
适用于 EnOS Edge |
|---|---|---|---|
创建 Application Portal 上的普通提示消息与告警消息 |
√ |
√ |
|
获取应用的权限点及菜单列表 |
√ |
√ |
|
获取消息图标可选择配置的颜色集合 |
√ |
√ |
|
获取消息可选择配置的提示声集合 |
√ |
√ |
|
通过 Access Token 获取当前用户有权限的应用的列表 |
√ |
√ |
|
更新消息状态 |
√ |
√ |
|
获取未确认的应用消息列表 |
√ |
√ |
通用错误码¶
代码 |
错误信息 |
描述 |
|---|---|---|
200 |
成功 |
|
400 |
parameter.invalid.[参数名] |
参数不合法 |
401 |
unauthenticated |
用户未登录 |
403 |
permission.denied |
无权访问或无权操作 |
404 |
[主体名].not.exist |
用户不存在 |
408 |
[主体名].already.existed |
用户已存在 |
409 |
[主体名] |
账号在另一地点登录 |
410 |
[主体名].expired |
[主体标识/值]失效 |
415 |
[].out.range |
参数值超出实际取值范围 |
429 |
[操作名.主体名].exhausted |
操作过于频繁，超过限制次数 |
500 |
system.internal.error |
系统错误 |
504 |
timeout |
服务超时 |
512 |
organization unselected |
用户未选择组织 |
31401 |
Please login first |
请先登录 Application Portal |
31403 |
This API can be requested through EnOS APIM only |
此 API 只能通过 EnOS APIM 调用 |