CLTPlatform SDK User Manual

# Server Status Codes (50000-59999)

Each status code corresponds to a possible outcome of an operation. Users can use these status codes to determine the result of their requests.

# Error Handling

In API calls, you may encounter the following server status codes, each indicating a potential error type. Here are common error types and suggested handling approaches:

# Server Basic Status Codes (50000-50099)

# 50008 RK Program Exception

  • Description: An exception occurred in the RK program.
  • Solution: Check the relevant logs and status of the RK program to ensure it is running normally, and fix any issues that could cause exceptions.

# 50009 Request Failure

  • Description: The request did not complete successfully.
  • Solution: Review the request details to ensure it meets the requirements and can be executed successfully. This may involve checking network connectivity, permissions, or other relevant factors.

# 50010 Server Exception

  • Description: An exception occurred on the server.
  • Solution: Check the server logs and status to identify the cause of the exception and take necessary steps to resolve the server issue.

# 50011 LedMaster Service Exception

  • Description: An exception occurred in the LedMaster service.
  • Solution: Check the status and logs of the LedMaster service to identify the specific cause of the service exception and perform necessary repairs or restart the service.

# 50012 Unable to Retrieve Data from Lower Layer

  • Description: Unable to retrieve required data from the lower layer.
  • Solution: Check the availability of the lower-layer data source to ensure it is operational, and fix any connection or configuration issues.

# 50013 Interface Does Not Exist

  • Description: The requested interface does not exist.
  • Solution: Confirm that the interface path and method are correct and that the interface has been properly deployed and configured. This may require fixing the interface path or checking whether the interface is correctly deployed on the server side.

# 50100 User Does Not Exist

  • Description: The user does not exist.
  • Solution: Ensure that the entered username or identifier is correct and verify that the user is registered or exists in the system.

# 50101 User Already Online

  • Description: The user is already logged in and cannot log in again.
  • Solution: Log out the currently logged-in user or wait for them to exit, then attempt to log in again.

# 50102 User Not Enabled

  • Description: The user account is not enabled.
  • Solution: Contact the system administrator to activate the user account so the user can log in and use the system.

# 50103 Incorrect Password

  • Description: The password entered by the user is incorrect.
  • Solution: Check that the password is entered correctly and re-enter the correct password.

# 50104 Empty Password

  • Description: The user password is empty.
  • Solution: Ensure that a password is entered and resubmit.

# 50105 Incorrect Password Length

  • Description: The user password length does not meet the requirements.
  • Solution: Ensure that the password length meets the system's specified requirements and set a new password.

# 50106 Invalid Password Characters

  • Description: The user password contains invalid characters.
  • Solution: Ensure that the password only contains allowed characters and set a new password.

# 50107 Username Already Exists

  • Description: The provided username already exists in the system.
  • Solution: Choose a different username to ensure uniqueness.

# 50108 Empty Username

  • Description: The username is empty.
  • Solution: Ensure that a username is entered and resubmit.

# 50109 Incorrect Username Length

  • Description: The username length does not meet the requirements.
  • Solution: Ensure that the username length meets the system's specified requirements and set a new username.

# 50110 Invalid Username Characters

  • Description: The username contains invalid characters.
  • Solution: Ensure that the username only contains allowed characters and set a new username.

# 50111 Insufficient Permissions

  • Description: The user does not have sufficient permissions to perform the requested operation.
  • Solution: Contact the system administrator to obtain the necessary permissions.

# 50112 User Limit Reached

  • Description: The number of registered users in the system has reached the maximum limit.
  • Solution: Contact the system administrator, which may require upgrading user licenses or cleaning up inactive users.

# 50200 Database Exception

  • Description: An exception occurred during database operations.
  • Solution: Check the database logs to get detailed error information and take necessary steps to resolve the database exception.

# 50201 Failed to Establish Database Connection

  • Description: Unable to establish a successful connection to the database.
  • Solution: Check whether the database server is running normally, ensure that the connection string and credentials are correct, and fix any issues that could cause connection failures.

# 50202 Record to Modify Does Not Exist

  • Description: The record to modify does not exist in the database.
  • Solution: Ensure that the record to be modified exists in the database, or confirm whether the record has been deleted.

# 50203 Unable to Delete Record with Associated Data

  • Description: The record to delete has associated data and cannot be directly deleted.
  • Solution: First remove associations or delete related data, then attempt to delete the record.

# 50300 Login Expired

  • Description: The user's login has expired and requires re-authentication.
  • Solution: Re-login to refresh authentication and ensure that the user remains active.

# 50301 Duplicate Submission Prohibited

  • Description: Duplicate submission of the same request is prohibited.
  • Solution: Ensure that each request has a unique identifier or use mechanisms to prevent duplicate submissions of the same request.

# 50400 Device Encryption/Decryption Password Incorrect

  • Description: The encryption/decryption password for the device is incorrect.
  • Solution: Ensure that the provided password is correct, or contact the system administrator to obtain the correct password.

# 50401 Nonexistent Board Card for Window

  • Description: The board card for the window does not exist.
  • Solution: Check that the board card for the window is correctly configured or exists, and fix any issues that could cause the nonexistence of the board card.

# 50402 Screen Group Limit Reached

  • Description: The number of screen groups has reached the system-specified limit.
  • Solution: Contact the system administrator to obtain more screen group licenses or organize existing screen group configurations.

# 50403 Background Image Storage Capacity Reached Limit

  • Description: The storage capacity for background images has reached the system-specified limit.
  • Solution: Clear or migrate background images, or contact the system administrator to obtain more storage capacity.

# 50404 Uploading Background Image in Progress

  • Description: The system is processing a background image upload request and cannot perform other operations simultaneously.
  • Solution: Wait for the background image upload to complete before performing other operations.

# 50405 Uploading Subtitle Image in Progress

  • Description: The system is processing a subtitle image upload request and cannot perform other operations simultaneously.
  • Solution: Wait for the subtitle image upload to complete before performing other operations.

# 50406 Uploading Software Upgrade File in Progress

  • Description: The system is processing a software upgrade file upload request and cannot perform other operations simultaneously.
  • Solution: Wait for the software upgrade file upload to complete before performing other operations.

# 50407 Manual Backup File Storage Capacity Reached Limit

  • Description: The storage capacity for manual backup files has reached the system-specified limit.
  • Solution: Clear or migrate backup files, or contact the system administrator to obtain more storage capacity.

These handling suggestions are for reference only, and specific actions may vary based on actual circumstances. When encountering issues, investigate according to the specific situation and take appropriate measures.

← Frequently Asked Questions Introduction →