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 |
|---|---|---|---|
| Get Token Information | 获取 Access Token 所对应的当前登录用户的相关信息 | √ | √ |
| Log In | 登录账号 | √ | √ |
| Log In Via Authorization Code | 通过单点登录（SSO）的授权码登录 | √ | × |
| Log Out | 登出账号 | √ | √ |
| Refresh Access Token | 使用 Refresh Token 请求一个新的 Access Token | √ | √ |
| Revoke Refresh Token | 撤销用户所有的 Refresh Token | √ | √ |
用户与组织¶
| 操作名称 | 描述 | 适用于 EnOS Cloud | 适用于 EnOS Edge |
|---|---|---|---|
| Choose Organization | 用户在登录后选择需要进入使用的组织 | √ | √ |
| Create and Join User | 不登录 Application Portal 的状态下创建用户并为该用户分配组织 | √ | × |
| Join Users | 不登录 Application Portal 的状态下把一批用户添加进组织 | √ | × |
| Get Manageable User List | 获取当前账号权限下可管理的所有用户列表 | √ | √ |
| Get Organization List | 根据 Access Token 列出当前用户所在的组织列表 | √ | √ |
| Get Organization Language List | 获取指定组织下可使用语言的列表 | √ | √ |
| Get Organization User List | 不登录 Application Portal 的状态下授权应用获取指定组织下所有用户列表 | √ | √ |
| Get Organization Roles | 获取组织内所有角色 | √ | √ |
| Get App User List | 根据应用的 accessKey 获得当前用户权限范围内对该应用可见的用户列表信息 |
√ | √ |
| Get User Information | 获取当前用户的信息 | √ | √ |
| Get User Domain | 通过用户邮箱地址获取用户所在的域信息 | √ | √ |
| Get User Structures | 获取用户所分配的组织结构节点 | √ | √ |
| Get User Roles | 获取用户被分配的角色 | √ | √ |
| Get User Permissions | 获取用户在当前应用下授权的权限点 | √ | × |
| Get User Base Info | 根据用户邮箱、账号和域、或电话号码和电话区号获取用户的基本信息如用户 ID 等 | √ | × |
| Get Users Asset List | 不登录 Application Portal 的状态下获取一批用户的资产权限 | √ | × |
| Get Users Role List | 不登录 Application Portal 的状态下获取一批用户的角色 | √ | × |
| Get Users Structure List | 不登录 Application Portal 的状态下获取一批用户的组织结构 | √ | × |
| Get Users UserGroup List | 不登录 Application Portal 的状态下获取一批用户的用户组 | √ | × |
| Assign Organization Structures | 不登录 Application Portal 的状态下给用户分配组织结构 | √ | × |
| Assign User Roles | 不登录 Application Portal 的状态下给用户分配角色 | √ | × |
| Assign User Groups | 不登录 Application Portal 的状态下给用户分配用户组 | √ | × |
| Remove Organization Structures | 不登录 Application Portal 的状态下给用户移除组织结构 | √ | × |
| Remove User Roles | 不登录 Application Portal 的状态下给用户移除角色 | √ | × |
| Remove User Groups | 不登录 Application Portal 的状态下给用户移除用户组 | √ | × |
| Remove User | 不登录 Application Portal 的状态下把一个用户移出一个组织 | √ | × |
资产¶
| 操作名称 | 描述 | 适用于 EnOS Cloud | 适用于 EnOS Edge |
|---|---|---|---|
| Authorize Asset | 将在 EnOS 平台上新建的资产授权给创建人 | √ | √ |
| Check Asset Permission | 查看是否有资产的权限 | √ | √ |
| Get Assets by Application | 获取当前用户在某个应用下有权限的所有资产 | √ | √ |
| Get Assets by Organization | 获取指定用户在指定组织下有权限的所有资产 | √ | √ |
| Get Asset Structure | 获取资产所在的组织结构的上游组织结构 | √ | √ |
| Get Structure Asset | 获取用户在组织结构上的资产 | √ | √ |
| Sync Asset | 将在 EnOS 平台上标有指定标签的资产同步到 Application Portal | √ | √ |
| Get Users with Asset Access | 获取对某一资产有权限的用户列表 | √ | √ |
应用¶
| 操作名称 | 描述 | 适用于 EnOS Cloud | 适用于 EnOS Edge |
|---|---|---|---|
| Create Message | 创建 Application Portal 上的普通提示消息与告警消息 | √ | √ |
| Get App Menu and Permission | 获取应用的权限点及菜单列表 | √ | √ |
| Get Colors of the Message Icon | 获取消息图标可选择配置的颜色集合 | √ | √ |
| Get Message Ringtones | 获取消息可选择配置的提示声集合 | √ | √ |
| Get User’s Applications | 通过 Access Token 获取当前用户有权限的应用的列表 | √ | √ |
| Update Message | 更新消息状态 | √ | √ |
| Get Unresolved Messages | 获取未确认的应用消息列表 | √ | √ |
通用错误码¶
| 代码 | 错误信息 | 描述 |
|---|---|---|
| 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 调用 |