H Series OpenAPI Instructions
Home
ChineseVersion
Home
ChineseVersion
  1. Devices
  • Instructions
  • Error Codes
  • Change History
  • Devices
    • Read Device Detailed Information
      POST
    • Read Device Card Information
      POST
    • Read Device IP
      POST
  • Homepage
    • Read System Initialization Status
      POST
    • Read Video Server Address
      POST
  • Screen
    • Set Screen Gamma
      POST
    • Display Screen ID
      POST
    • Set Screen Brightness
      POST
    • Save Screen Brightness
      POST
    • Add Screens
      POST
    • Delete Screens
      POST
    • Read Screen Detailed Information
      POST
    • Query Screen List
      POST
    • Screen FTB
      POST
    • Set BKG
      POST
    • Set Freezing
      POST
    • Read Screen Not in Live Mode
      POST
    • Set 3D Effect
      POST
    • Set Screen Layout Information
      POST
    • Set Image OSD
      POST
    • Set Text OSD
      POST
    • Delete Multiple Screens
      POST
    • Rename Screens
      POST
  • Inputs
    • Read Input List
    • Read Detailed Information of Specified Inputs
    • Set Cropping
    • Delete
    • Edit Cropping
    • Set Resolutions
    • Set Timing
    • Create Input Groups
    • Sort Input Groups
    • Edit Groups
    • Delete Groups
    • Delete Input Sources by Groups
    • Import EDID
    • Rename
    • Create Signal Source Playlists
    • Read Signal Source Playlists
    • Edit Signal Source Playlist Information
    • Enable Signal Source Playlists
    • Delete Signal Source Playlists
  • Outputs
    • Set Image Quality
    • Set Gamma
    • Set Output Locating
    • Rename
    • Set Timing for 4K Output Card
    • Read Detailed Information
    • Read Output List
    • Se Output Timing
    • Set Output Resolutions
    • Set Areas Loaded by All-in-One Cards
  • Layers
    • Set Stream Pulling Rules for IPC Sources Only
    • Add Layers
    • Delete Layers
    • Read Layer List
    • Read Layer Details
    • Set Layer Basic Information
    • Read Layer Z-order
    • Set Layer Information
    • Clear Layers
    • Set Layer Z-order
    • Lock Layers
    • Change Layer Source Information
    • Freeze Layers
    • Open Layer Layouts
  • Presets
    • Create Presets
    • Delete Presets
    • Set Basic Information of Specified Presets
    • Load Presets
    • Read Detailed Information of Specified Presets
    • Clear Presets
    • Get Preset Group List
    • Create Preset Groups
    • Delete Preset Groups
    • Get Preset Group Enumeration
    • Play Preset Playlist
    • Read All Presets
    • Read Preset Playlist
    • Read Current Played Preset
    • Edit Preset Groups
    • Overwrite Presets
  • BKG
    • Create BKG
    • Delete BKG
    • Get BKG Detailed Information
    • Comprehensive Query
  • IPC
    • IPC Source List
    • Read Specified Data in IPC Source List
    • IP Camera List
    • Obtain IPC Source Channel List
    • Obtain Details of IPC Source Channel List
    • Details of IPC Mosaic Source Channel Data
    • Add IPC Sources
    • Delete IPC Sources
    • Rename IPC Sources
    • Change IPC Source Channels
    • Add IPC Source Channels
    • Delete IPC Source Channels
    • IPC Source Slot List
    • IPC Sources and Channels
    • Check IPC Source Names
    • IPC Source Group List
    • Create IPC Source Groups
    • Delete IPC Source Groups
    • Change IPC Groups
    • Delete IPC Source Group Nodes
    • IPC Mosaic Source List
    • Create IPC Mosaic Source Templates
    • Update IPC Mosaic Source Templates
    • Delete IPC Mosaic Source Templates
    • Apply IPC Mosaic Source Templates
    • Rename IPC Mosaic Sources
  1. Devices

Read Device Card Information

POST
/open/api/device/readCardVersion
FieldDescription
deviceIdDevice ID
versionVersion number
modelIdCard modelId
MCUMCU version
FPGAFPGA version
briefDescribe the detailed information of the current version.
snCard SN, length: 8 digits
hardverHardware version
filenameFile name
internalverChip internal version number, format: year-month-date-hour-minute (201909061010)
cardTypeCard type
codeInternal card updating code
funcCodeSet whether to enable the rotation function. 0x80: Enable
rotateEnableWhether the card supports connector rotation. 1: Support

Request

Body Params application/json

Example
{
    "body": {
        "deviceId": 0
    },
    "sign": "Y2YxNjE4NjRmZTFlOThhODIxMDNhOWY2YmU4MzU5ODk=",
    "pId": "ZTlj",
    "timeStamp": "1689586062335"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/open/api/device/readCardVersion' \
--header 'Content-Type: application/json' \
--data-raw '{
    "body": {
        "deviceId": 0
    },
    "sign": "Y2YxNjE4NjRmZTFlOThhODIxMDNhOWY2YmU4MzU5ODk=",
    "pId": "ZTlj",
    "timeStamp": "1689586062335"
}'

Responses

🟢200Successful
application/json
Body

Example
{
    "body": {
        "auxcard": {
            "FPGA": {
                "brief": "2025.09.09 H-AUX-2U V2.0.0.0",
                "code": 256,
                "filename": "FPGA.dat",
                "internalver": "app202504072132",
                "version": "2.0.0.0"
            },
            "MCU": {
                "brief": "2025.09.09 H-AUX-2U V2.0.0.0",
                "code": 0,
                "filename": "MCU.dat",
                "internalver": "app202501152104",
                "version": "2.0.0.0"
            },
            "brief": "2025.09.09 H-AUX-2U V2.0.0.0",
            "folderPath": "H_AUX_2U",
            "hardver": "1.1",
            "modelId": 31618,
            "sn": "ffffffffffffffff",
            "version": "2.0.0.0"
        },
        "brief": "Hseries",
        "deviceId": 0,
        "inputCard": [
            {
                "FPGA": {
                    "brief": "2025.09.17 H-4xFiber-I V2.0.0.0",
                    "chipBrief": "",
                    "code": 256,
                    "filename": "FPGA.dat",
                    "funcBrief": "",
                    "internalver": "app202509021543",
                    "version": "2.0.0.0"
                },
                "MCU": {
                    "brief": "2025.09.17 H-4xFiber-I V2.0.0.0",
                    "chipBrief": "",
                    "code": 0,
                    "filename": "MCU.dat",
                    "funcBrief": "",
                    "internalver": "app202509152204",
                    "version": "2.0.0.0"
                },
                "brief": "2025.09.17 H-4xFiber-I V2.0.0.0",
                "folderPath": "H_2xFiber_I",
                "hardver": "1.0",
                "modelId": 31504,
                "slotId": 2,
                "sn": "0032ae0100000388",
                "version": "2.0.0.0"
            }
        ],
        "mainControl": {
            "ARM": {
                "brief": "2025.09.09 MAIN CTRL V2.0.0.0",
                "code": 0,
                "filename": "CtrlCardExec.sh",
                "internalver": "app202509090920",
                "version": "V2.0.0.0"
            },
            "FPGA": {
                "brief": "2025.09.09 MAIN CTRL V2.0.0.0",
                "code": 256,
                "filename": "",
                "internalver": "app202509090920",
                "version": "V2.0.0.0"
            },
            "brief": "2025.09.09 MAIN CTRL V2.0.0.0",
            "folderPath": "H_Ctrl",
            "hardver": "1.0",
            "modelId": 29965,
            "sn": "0102030405060708",
            "version": "V2.0.0.0"
        },
        "outputCard": [
            {
                "FPGA": {
                    "brief": "2025.09.29 H-4xDVI-O V2.0.0.0.T2_Scaler_ddr_error",
                    "code": 256,
                    "filename": "FPGA.dat",
                    "internalver": "app202509282048",
                    "version": "2.0.0.0"
                },
                "MCU": {
                    "brief": "2025.09.29 H-4xDVI-O V2.0.0.0.T2_Scaler_ddr_error",
                    "code": 0,
                    "filename": "MCU.dat",
                    "internalver": "app202507181117",
                    "version": "2.0.0.0"
                },
                "brief": "2025.09.29 H-4xDVI-O V2.0.0.0.T2_Scaler_ddr_error",
                "dynamicSubPixeEnable": 0,
                "folderPath": "H_4xDVI_O",
                "funcCode": 0,
                "funcs": [
                    {
                        "code": 256,
                        "filename": "FPGA_ROTATE.dat",
                        "funcEnable": 128,
                        "type": 256
                    }
                ],
                "hardver": "1.0",
                "modelId": 31552,
                "rotateEnable": 1,
                "slotId": 4,
                "sn": "002c8e0100000040",
                "version": "2.0.0.0"
            },
            {
                "FPGA": {
                    "brief": "2025.09.09 H-8xFiber-O V2.0.0.0",
                    "code": 256,
                    "filename": "FPGA.dat",
                    "internalver": "app202509052109",
                    "version": "2.0.0.0"
                },
                "MCU": {
                    "brief": "2025.09.09 H-8xFiber-O V2.0.0.0",
                    "code": 0,
                    "filename": "MCU.dat",
                    "internalver": "app202509091011",
                    "version": "2.0.0.0"
                },
                "brief": "2025.09.09 H-8xFiber-O V2.0.0.0",
                "dynamicSubPixeEnable": 0,
                "folderPath": "H_8xFiber_O",
                "funcCode": 0,
                "funcs": [],
                "hardver": "1.0",
                "modelId": 31567,
                "rotateEnable": 0,
                "slotId": 5,
                "sn": "ffffffffffffffff",
                "version": "2.0.0.0"
            }
        ],
        "version": "V2.0.0.0"
    },
    "msg": "",
    "sign": "",
    "status": 0
}
Modified at 2025-10-23 10:05:57
Previous
Read Device Detailed Information
Next
Read Device IP
Built with