Application Portal Service Overview


The EnOS Application Portal is a unified EnOS-based application login portal. You can get information about users, assets, and applications through the Application Portal service to facilitate the configuration of permissions on the EnOS Application Portal.


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.

Authentication

Operation Name Description
Get Token Information Get information about the user who is currently logged-in through the access token
Log In Log in to the account
Log In Via Authorization Code Log in Application Portal via authorization code
Log Out Log out of the account
Refresh Access Token Request a new access token using the refresh token
Revoke Refresh Token Revoke a user’s refresh token

User and Organization

Operation Name Description
Choose Organization Select the organization that the user needs to use after login
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 App User List Based on the accessKey of an application, get the list of users who have access to the application
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

Asset

Operation Name Description
Authorize Asset Authorize the new asset created on EnOS platform to the asset creator
Check Asset Permission Check if the current user has the access permission for the queried asset
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 Structure Asset Get all the assets that the user can access under an organization structure
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

Application

Operation Name Description
Create Message Create common messages and alert messages on the Application Portal
Get App Menu and Permission Get the list of application menus and permissions
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
Update Message Update the status of the message
Get Unresolved Messages Get the list of unresolved messages that are reported for the applications

Common Error Codes

Code Error Information Description
200   Success
400 parameter.invalid.[parameter name] The [parameter name]([parameter value]) is invalid. For example, parameter.invalid.userId indicates that the userId is invalid.
401 unauthenticated Please authentication first. Indicates that the user has not logged on.
403 permission.denied Permission denied. Indicates that user has no permission to access or perform operations.
404 [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.
408 [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.
409 [] The [entity name]([entity ID]) is conflict. Indicates that the account has been logged on from a different location.
410 [entity name].expired The [entity name]([entity ID/value]) is expired. For example, cache.token.expired indicates that the token has expired.
415 [].out.range The []([]) is out of range
429 [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.
432 [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).
500 system.internal.error System internal error
504 timeout Service timeout
512 organization unselected Please select organization first. Indicates that the user has not selected an organization.