• Documentation
• About Application Portal API

About Application Portal API

EnOS Application Portal is a unified portal for permission management and application access. You can get information on users, assets, and applications by Open APIs provided by Application Portal APIs to facilitate application development or permission management.

For more information about Application Portal, see About Application Portal.
For more information about EnOS APIs, see About EnOS API.
To learn how to call an EnOS API, see Get Started with EnOS API.

Java SDK

To use enos-app-portal-sdk in your project, you’ll need to add the following dependencies to the pom.xml file. You may need to change the version number accordingly.

<dependency>
  <groupId>com.envisioniot</groupId>
  <artifactId>enos-app-portal-sdk</artifactId>
  <version>0.0.25</version>
</dependency>

APIs

Authentication

Operation Name	Description	Available on EnOS Cloud	Available on EnOS Edge
Confirm Password	Confirm the password of a login user	√	×
Get Token Information	Get information about the user who is currently logged-in through the access token	√	√
Get Password Token	Get the token for resetting the password of a user	√	×
Log In	Log in to the account	√	√
Log In Via Authorization Code	Log in to Application Portal by using the Single Sign-On authorization code	√	×
Log Out	Log out of the account	√	√
Refresh Access Token	Request a new access token using the refresh token	√	√
Reset Password with Token	Reset the password of a user with the token	√	×
Revoke Refresh Token	Revoke a user’s refresh token	√	√
Send Code	Send a verification code to a user’s email	√	×
Verify Code	Verify a verification code	√	×

User and Organization

Operation Name	Description	Available on EnOS Cloud	Available on EnOS Edge
Choose Organization	Select the organization that the user needs to use after login	√	√
Create and Join User	Create a user and assign an OU to the user without logging in to Application Portal	√	×
Create or Update Menu Group	Create or update a menu group	√	×
Create User with Password	Create a user with default password, and add the user to an OU	√	×
Create Log	Create a record of audit logs	√	×
Create Role	Create organization structure nodes	√	×
Create Organization Structure	Create a role	√	×
Delete Organization Structure	Delete organization structure nodes	√	×
Join Users	Assign users to an organization without logging in to Application Portal	√	×
Get Application Authorization	Get the API authorization information of an application in a specified OU	√	×
Get Manageable User List	List all users that can be managed under the current account	√	√
Get Organization List	List the organizations which the current user belongs according to the access token	√	√
Get Organization Language List	Get the list of languages available for an organization	√	√
Get Organization User List	Authorize the application to get a list of all the users under a specified organization without logging in to the Application Portal	√	√
Get Organization Roles	Get all roles under an organization structure	√	√
Get Application Menu Group	Get the menu groups of an application	√	×
Get App User List	Based on the accessKey of an application, get the list of users who have access to the application	√	√
Get Organization User Group List	Get all user groups in an OU	√	×
Get Role Permission	Get the menu groups, operational permissions, and visible organization structures assigned to a role	√	×
Get Structure by App	Get the organization structure root node assigned to an application	√	×
Get Structure by Detail	Get all organization structure nodes assigned to an application	√	×
Get Structure by User	Get the organization structures that are available for user	√	×
Get Users by Role	Get user list of a role	√	×
Get Users by User Group	Get user list of a user group	√	×
Get User Information	Get the information of the current user	√	√
Get User Domain	Get the domain information of a user using the email address	√	√
Get User Structures	Get information of the organization structure to which a user is assigned	√	√
Get User Roles	Get all roles that are assigned to a user	√	√
Get User Permissions	Get the permissions that are assigned to a user for the current application	√	×
Get User Base Info	Get basic information about a user, such as the user ID, based on the user’s email, account and domain, or phone number and phone area code	√	×
Get Users Asset List	Get the asset permissions of users without logging in to Application Portal	√	×
Get Users Role List	Get the roles of users without logging in to Application Portal	√	×
Get Users Structure List	Get the organization structures of users without logging in to Application Portal	√	×
Get Users UserGroup List	Get the user groups of users without logging in to Application Portal	√	×
Assign Organization Structures	Assign organization structures to a user without logging in to Application Portal	√	×
Assign Assets to Organization Structure	Assign assets to organiztion structure nodes	√	×
Associate Resource to Organization Structure Node	Associate a resource to a specified organization structure node	√	×
Assign User Roles	Assign roles to a user without logging in to Application Portal.	√	×
Assign User Groups	Assign user groups to a user without logging in to Application Portal.	√	×
Query Audit Logs	Query audit logs	√	×
Query Menu Access Logs	Query the user events on menu access	√	×
Remove Organization Structures	Remove organization structures for a user without logging in to Application Portal.	√	×
Remove User Roles	Remove roles for a user without logging in to Application Portal.	√	×
Remove User Groups	Remove user groups for a user without logging in to Application Portal.	√	×
Remove User	Remove a user from an OU without logging in to Application Portal.	√	×
Update Application Authorization	Update organization structure nodes	√	×
Update Organization Structure	Update the API authorization information of an application in a specified OU	√	×
Update Role Permission	Assign or remove menu groups, operational permissions, or visible organization structures to/from a role	√	×
Update User Asset Permission	Assign or remove asset permissions to/from a user	√	×
Update User Information	Update user information	√	×

Resource

Operation Name	Description	Available on EnOS Cloud	Available on EnOS Edge
Authorize Asset	Authorize the new asset created on EnOS to the asset creator	√	√
Check Asset Permission	Check if the current user has the access permission for the queried asset	√	√
Create Resource Type	Create a resource type	√	×
Delete Resource	Delete resources	√	×
Delete Resource Type	Delete resource types	√	×
Get Assets by Application	Get all assets that the current user can access under a specified application	√	√
Get Assets by Organization	Get all the assets that a specified user can access under a specified organization	√	√
Get Asset Structure	Get the upstream organizational structure where the asset is located	√	√
Get Resource List	Get the list of resources	√	×
Get Resource Type	Get the list of resource types.	√	×
Get Structure Asset	Get all the assets that the user can access under an organization structure	√	√
Register Resource	Register a resource	√	×
Sync Asset	Synchronize assets on the EnOS to the Application Portal	√	√
Get Users with Asset Access	Get the list of users who have access permission to a specific asset	√	√
Update Resource	Update resource information	√	×
Update Resource Type	Update resource type information	√	×

Application

Operation Name	Description	Available on EnOS Cloud	Available on EnOS Edge
Create Message	Create common messages and alert messages on the Application Portal	√	√
Create Message Rules	Create message rules	√	×
Delete Message Rules	Delete message rules	√	×
Get Application Information	Get the information of an application	√	×
Get App Menu and Permission	Get the list of application menus and permissions	√	√
Get App Resources by User and Organization	Get the list of application permission points and menus	√	×
Get Colors of the Message Icon	Get the list of colors for configuring the message icon	√	√
Get Message Ringtones	Get the list of ringtones for configuring the message	√	√
Get User’s Applications	Get a list of applications that the current user has permission to access through the access token	√	√
Get Unresolved Messages	Get the list of unresolved messages that are reported for the applications	√	√
Search Message Rules	Search message rules	√	×
Update Application Information	Update the information of an application	√	×
Update Message Rules	Update message rules	√	×
Update Message	Update the status of the message	√	√

API Editions

The following table lists the API services included in Application Portal Enterprise and Lightweight editions.

Category	Enterprise	Lightweight
Authentication APIs	√	√
User and Organization APIs	√	√
Resource APIs	√	√
Application APIs	√	√

Common Error Codes

Code	Error Information	Description
0		Success
31400	parameter.invalid.[parameter name]	The [parameter name]([parameter value]) is invalid. For example, parameter.invalid.userId indicates that the userId is invalid.
31401	unauthenticated	Please authentication first. Indicates that the user has not logged on.
31403	permission.denied	Permission denied. Indicates that user has no permission to access or perform operations.
31404	[entity name].not.exist	The [entity name]([entity ID]) does not exist. For example, user.not.exist indicates that the user does not exist, and organization.user.not.exist indicates that the user does not exist under the organization.
31408	[entity name].already.existed	The [entity name]([entity ID]) is already existed. For example, user.already.existed indicates that the user alreadys exists, and organization.user.already.existed indicates that the user already exists under the organization.
31409	[]	The [entity name]([entity ID]) is conflict. Indicates that the account has been logged on from a different location.
31410	[entity name].expired	The [entity name]([entity ID/value]) is expired. For example, cache.token.expired indicates that the token has expired.
31415	[].out.range	The []([]) is out of range
31429	[operation name.entity name].exhausted	Try [operation name.entity name] too many times. Please try again [time] later. For example, login.ip.exhausted indicates that there are too many login attempts from the IP address.
31432	[entity name].too.many	Too many [entity name]. For example, user.too.many indicates that there are too many instances of the user (there should only be one instance）.
31500	system.internal.error	System internal error
31504	timeout	Service timeout
31512	organization unselected	Please select organization first. Indicates that the user has not selected an organization.