HealthPro: Sending SUNAPI CGI Commands from HealthPro

Applies to: HealthPro

Summary

From HealthPro version 1.8 and up, you can send SUNAPI CGI commands from HealthPro via HealthPro Bridge to licensed Hanwha Vision cameras, or directly to Direct-to-Cloud cameras.

This advanced feature should be used with extreme caution, as it could disable a camera if, for example, network settings are changed.

The primary tool for camera configuration is Wisenet Device Manager with direct network access. Nevertheless, using HealthPro to issue SUNAPI commands is a powerful tool to make widespread remote changes, or to check settings.

This article explains how to send commands to read the settings and change them.

Understanding SUNAPI

SUNAPI commands are HTTP URLs. The command syntax is as follows:

Each URL specifies the target device’s IP address and the CGI that provides the command. The URL is followed by a query string that specifies the command’s submenu, action, and parameters. For example, to view the system’s general device information in HealthPro you would use  /stw-cgi/system.cgi?msubmenu=deviceinfo&action=view, which would return a string containing all the device info, e.g.
{"Model":"XNV-9083R","SerialNumber":"ZRG070GR50000KE","FirmwareVersion":"2.23.08_20250718_R29"…

For the complete SUNAPI documentation, including error codes, contact your Hanwha Vision sales representative. To see a comprehensive list of attributes and capabilities of Hanwha Vision devices use attributes.cgi (stw-cgi/attributes.cgi).

Sending SUNAPI CGI Commands

To send SUNAPI CGI commands: 

1. Log in to HealthPro.
   
   
2. Select Settings > Remote Config > Advanced.
   
   
   
   
3. Click OK to acknowledge the warning.
   
   
4. Enter the command (maximum 200 characters).
   
   
   
   

   NOTE: Prepend the ‘/’ character before each command, otherwise an 
   invalid command error appears.

5. Select all the cameras to send your CGI command and click Apply.
   
   
   
   The outcome appears for each device selected.
   
   
   
   o Success: command was successfully executed, for example:
       /stw-cgi/security.cgi?msubmenu=ssl&action=view
   
   o Failure: tried but failed to execute the command, for example:
       /stw-cgixxx/security.cgi?msubmenu=sslx&action=view
       /stw-cgi/securityxxx.cgi?msubmenu=ssl&action=view
       /stw-cgi/security.cgi?msubmenu=ssl&action=viewxxx
   
   o Unsupported: the msubmenu is just not supported by that specific model, or, it may contain a typo and is not supported for any model. For example:
      /stw-cgi/security.cgi?msubmenu=sslxxx&action=view
      /stw-cgi/security.cgi?msubmenuxxx=ssl&action=view
   
   
   
   
6. Click on the device row to see the response to the command.
   
   

Command Table

Use the following commands as listed.