Get Nodes

Get all nodes of zone.

Description

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

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

Request Topic

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

Request Payload

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

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")
zone_address	string	Yes	Zone Address should be like this : data > zone_address
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/ZONE/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": "dimmer",
        "element_name": "Dimmer 2",
        "unicast_address": 1318,
        "node_address": 1312,
        "groups": [
          { 
            "group_address": 59434, 
            "group_name": "test group " 
          }
        ],
        "scenes": []
      },
      {
        "type": "switch",
        "element_name": "Master",
        "unicast_address": 1312,
        "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": "switch",
        "element_name": "Switch 2",
        "unicast_address": 1314,
        "node_address": 1312,
        "groups": [],
        "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

2. Zone Not Found Error (Code: 2005)

{
  "message": "error",
  "message_type": {
    "code": 2005,
    "message": "Zone not found",
    "errorCode": "ZONE_NOT_FOUND"
  }
}

When it occurs:

• The zone address is invalid
• The zone has been deleted

How to resolve:

1. Verify the zone address is correct
2. Check if you have the necessary permissions
3. Ensure the zone exists

3. Constraint Error (Code: 3005)

a. Zone Address Error

{
  "message": "error",
  "message_type": {
    "code": 3005,
    "message": "zone_address must be a number",
    "errorCode": "CONSTRAINT_ERROR"
  }
}

b. Version Error

{
  "message": "error",
  "message_type": {
    "code": 3005,
    "message": "version must be one of the following values: v1.0",
    "errorCode": "CONSTRAINT_ERROR"
  }
}

c. Action Error

{
  "message": "error",
  "message_type": {
    "code": 3005,
    "message": "action must be one of the following values: get, get-zones, get-nodes, get-scenes, get-groups",
    "errorCode": "CONSTRAINT_ERROR"
  }
}

Constraint errors occur in the following cases:

1. Zone Address Constraints:

   • Zone Address must be a number
   • Zone Address field should not be empty
   • Zone Address field has incorrect type

2. Action Constraints:

   • Action must be one of: get, get-zones, get-nodes, get-scenes, get-groups
   • Action field is missing
   • Action field has incorrect value

3. Version Constraints:

   • Version must be exactly "v1.0"
   • Version field is missing
   • Version field has incorrect format

Resolution:

• Always use "v1.0" as the version value
• Use "get-nodes" as the type value
• Ensure zone address is correct
• Validate all parameters before sending

Error Code Summary

Code	Error Code	Description	Solution
2002	PROJECT_NOT_FOUND	Project doesn't exists	Check project UUID valid or not
2005	ZONE_NOT_FOUND	Zone doesn't exists	Check zone address valid or not
3005	CONSTRAINT_ERROR	Parameter validation failed	Check input values