Get Nodes

Get all nodes in a project.

Description

This action allows you to retrieve all nodes within a project, including:

• Node Name
• Node Address
• Product ID (PID) and Version ID (VID)
• Zone Information

Request Topic

LYT/41e0d6b2-37de-43d8-a348-4ba94853b6cd/PROJECT/ACTION

Request Payload

{
   "version": "v1.0",
   "action": "get-nodes",
   "limit": 2,
   "offset": 1
}

Request Field Descriptions

Field	Type	Required	Description
version	string	Yes	API version identifier (must be "v1.0")
action	string	Yes	Action to perform (must be "get-nodes")
limit	number	No	Maximum number of records to return (default: 50)
offset	number	No	Number of records to skip (default: 0)

Response Topic

LYT/41e0d6b2-37de-43d8-a348-4ba94853b6cd/PROJECT/E/ACTION

Response Payload

Success Response

{
  "message": "success",
  "version": "v1.0",
  "action": "get-nodes",
  "data": [
    {
      "node_name": "LYTIVA_A0A8E6",
      "product_id": "A008",
      "version": "0269",
      "node_address": 1312,
      "zone_name": "Test 1",
      "zone_address": 63035,
      "elements": [
        {
          "type": "switch",
          "element_name": "Switch 1",
          "unicast_address": 1313,
          "node_address": 1312,
          "groups": [
            { 
              "group_address": 59434, 
              "group_name": "test group " 
            }
          ],
          "scenes": [
            {
              "scene_number": 47637,
              "scene_name": "test scene",
              "configuration": { "power": false }
            }
          ]
        },
        {
          "type": "switch",
          "element_name": "Master",
          "unicast_address": 1312,
          "node_address": 1312,
          "groups": [],
          "scenes": []
        },
        {
          "type": "switch",
          "element_name": "Switch 2",
          "unicast_address": 1314,
          "node_address": 1312,
          "groups": [],
          "scenes": []
        },
        {
          "type": "switch",
          "element_name": "Switch 3",
          "unicast_address": 1315,
          "node_address": 1312,
          "groups": [],
          "scenes": []
        },
        {
          "type": "switch",
          "element_name": "Switch 4",
          "unicast_address": 1316,
          "node_address": 1312,
          "groups": [],
          "scenes": []
        },
        {
          "type": "dimmer",
          "element_name": "Dimmer 2",
          "unicast_address": 1318,
          "node_address": 1312,
          "groups": [
            {
             "group_address": 59434, 
             "group_name": "test group " 
            }
          ],
          "scenes": []
        },
        {
          "type": "dimmer",
          "element_name": "Dimmer 1",
          "unicast_address": 1317,
          "node_address": 1312,
          "groups": [],
          "scenes": [
            {
              "scene_number": 47637,
              "scene_name": "test scene",
              "configuration": { "dimming": 46 }
            }
          ]
        }
      ]
    },
    ...
  ]
}

Error Handling

1. Project Not Found Error (Code: 2002)

{
   "message": "error",
   "message_type": {
      "code": 2002,
      "message": "Project not found",
      "errorCode": "PROJECT_NOT_FOUND"
   }
}

When it occurs:

• The project UUID is invalid
• The project has been deleted
• The user doesn't have access to the project

How to resolve:

1. Verify the project UUID is correct
2. Check if you have the necessary permissions
3. Ensure the project exists
4. Contact system administrator if you should have access

Error Code Summary

Code	Error Code	Description	Solution
2002	PROJECT_NOT_FOUND	Project doesn't exist	Check project UUID valid or not