Device group | Freshliance

Device Group Page

Interface Description

Obtain the device group page based on the query conditions.

Interface Method

`tracker.deviceGroup.page

Request Parameter

Name	Type	Required	Description	Example
pageNum	int	Yes	Page number, starting from 1	1
pageSize	int	Yes	Page size, 1-50 items	10
groupName	string	No	Group name, fuzzy search	room

Return Data

Name	Type	Required	Description	Example
total	int	Yes	Total number	3
rows	array[object]	Yes	Data
rows.userGroupId	int	Yes	Device group ID	196
rows.groupName	string	Yes	Device group name	room A

Example for Requesting Parameter

{
  "appId": 658409073956360262328652394,
  "method": "tracker.deviceGroup.page",
  "format": "JSON",
  "charset": "UTF-8",
  "signType": "RSA2",
  "timestamp": "1747635013947",
  "version": "1.0",
  "bizContent": {
    "pageNum": 1,
    "pageSize": 10
  },
  "sign": "WYu7DvBTRuL0eWqNlKKzaQED24OmOEC5MPAnrxnoD0J7g8t9SzCUmXyZTgclReYW2qJWCESAkbW5L7qLlwwsPucb0k68WxCNwFB9FitOAalrXA6cOewBtsTmK0a8Upr0TESQYftSshQ/ZUbQLsEMTwNIPMtjiFfXrtHlaF78P/HVq0jV40mworgCAvDsLX/kXNvGZUluwn8iqw4l/mjsA7CppcFMSY/+r8SQTCQ5pCW8cGp0RNsVtdtR7x47V70Jl12g+GHbTMMebn72ejSM2VwjhV5HARK6KZfTx4ey/fJNUcHE07XAB8PvQnd9uSI1PFzixg7XUvMeOjGfUjOpqg=="
}

Example for Returning Data

{
  "code": "0",
  "data": {
    "total": 3,
    "rows": [
      {
        "userGroupId": 196,
        "groupName": "room C"
      },
      {
        "userGroupId": 193,
        "groupName": "room B"
      },
      {
        "userGroupId": 169,
        "groupName": "room A"
      }
    ]
  },
  "msg": "success",
  "sign": "E0OXjqpgzcOfqFq8xVo7mwQ0W6y6wY9tUVWHz1cQgrxJH5pUhZ7pDtsLxDQSYZCe55QCXW3RA3DL2lbmdep2RCSM5NAKLmAXQY6foh5Vdvx/wx8l4RUb8qaAFIlV3ImHLNxCGk2+pu1nzgExDduqWh/qGyuDe7TYObps0dK2wbt6yOaB12LrSOLMTfWwnU4n5uCEU5OxyF5XGed2sXXM/LTHBUmUW8liZe0j2DR87vPTxZn4/X/JCEHkEgMgHXcgMeAslvDJQOjuCL3w3hyLQCiVi5Iurh6mGg7KnS+zM8CwSYjz9azclPOadqfpgfmrr0UGnLQvS1x0PPs7NsXH3g==",
  "subCode": "",
  "subMsg": ""
}

Create A New Group

Interface Description

Create a new device group.

Interface Method

tracker.deviceGroup.create

Request Parameter

Name	Type	Required	Description	Example
groupName	string	Yes	Group name	room D

Return Data

Name	Type	Required	Description	Example
data	bool	Yes	true: Success; false: Failed	true

Example for Requesting Paramter

{
  "appId": 658409073956360262328652394,
  "method": "tracker.deviceGroup.create",
  "format": "JSON",
  "charset": "UTF-8",
  "signType": "RSA2",
  "timestamp": "1747635757379",
  "version": "1.0",
  "bizContent": {
    "groupName": "room D"
  },
  "sign": "C8FSPlyPurwaqUUxwJ9gXCGnmBJZr5i76pq/sVvTILEDWqIKsTrH+RRCXNzqIbuC33hchPHHKY+S3e5EaXrJISkYwD+RB+CNoVUlD0Gqn6mLf/gaUEHeov/3G/eZ9wgUg5QxLiIC0IP0Wn6KuZs+UcBm40DNK/KxbobE0h6iFQDAffly++NFcCqMCy/4JOdFXnqjuj8hfbGrhPu5y66GWFAbll4IoHpaiA6y0ZZzNfL7GToqfEIKNAIpATc/n6tn+Fh/gKGCXYK9I+VSjXiqlCsqm0PMeEnTZM/YgzsYZsdLHelsTabpk1b0MlnviPENXCLGXeUZIrIfPbWljtOVCg=="
}

Example for Returning Data

{
  "code": "0",
  "data": true,
  "msg": "success",
  "sign": "eAnF+imkUl+PQSOKAT4d01WSpCg+qH2a/ai/QqDbzoGiMMAAduoXGj36aTbs0iM7WEvoCrqwrPSP7G2ASOEZVCWlCna0WK3OX15wj8JMJ1cd5USoyBo44IW0mTLHs5bTjy73yEqF/g50F1ZeJvBw+aESSji5S48oGvrH1wXaSfCTZQ5+ReL9ZHvzU2lWVSfpS9DCuQ7f6g3uYBNWKAVVeRSki95Awsv4Yiqi8SBOa2ERbXmwp6LGllBEpJNarBf5VAvHUGeDSWD2nQWPsyWceZaAfViQCYf7jdMZ8JmI6bQHrYuCnhHLAjaI84DozDGc3CadZHdgOjwsO57nz9WPeQ==",
  "subCode": "",
  "subMsg": ""
}

Modify Device Group

Interface Description

Modify device group.

Interface Method

tracker.deviceGroup.update

Request Parameter

Name	Type	Required	Description	Example
userGroupId	int	Yes	Device group ID	203
groupName	string	Yes	Device group name	room

Return Data

Name	Type	Required	Description	Example
data	bool	Yes	true: Success; false: Failed	true

Example for Requesting Parameter

{
  "appId": 658409073956360262328652394,
  "method": "tracker.deviceGroup.update",
  "format": "JSON",
  "charset": "UTF-8",
  "signType": "RSA2",
  "timestamp": "1747636074560",
  "version": "1.0",
  "bizContent": {
    "userGroupId": 203,
    "groupName": "room"
  },
  "sign": "cXngZwmNzNURikyZBPVv1qK3KudnDuuaSwcnr8bLMqWQbq7y4uz04V6O1lyYqAfFffef1+h/5xj9RnMSTlYK7bvw5wPzWQn5N8gHtNlQUAgN/k/0DGS2AHVTeChyLdS85u6B5vFCC5G8nn/go0kmaQWElf/d1W4RSYA05v8vN+EsNw6bIF/DJVaJ36nzW5g+zGQ42I1p0Loj5xFJbtmYvJPg+A0Zq0BxVj03u1wMFE5F5JcSQGiefjzBLBFRfx1G8HWrryLsVajx3BafeJohya3FSxbEaHkcOTtjBjgv/SGy2khZbCjkWEtMq0W7x8eUjv4oV5b1P/PbDO4v26IbAQ=="
}

Example for Returning Data

{
  "code": "0",
  "data": true,
  "msg": "success",
  "sign": "eAnF+imkUl+PQSOKAT4d01WSpCg+qH2a/ai/QqDbzoGiMMAAduoXGj36aTbs0iM7WEvoCrqwrPSP7G2ASOEZVCWlCna0WK3OX15wj8JMJ1cd5USoyBo44IW0mTLHs5bTjy73yEqF/g50F1ZeJvBw+aESSji5S48oGvrH1wXaSfCTZQ5+ReL9ZHvzU2lWVSfpS9DCuQ7f6g3uYBNWKAVVeRSki95Awsv4Yiqi8SBOa2ERbXmwp6LGllBEpJNarBf5VAvHUGeDSWD2nQWPsyWceZaAfViQCYf7jdMZ8JmI6bQHrYuCnhHLAjaI84DozDGc3CadZHdgOjwsO57nz9WPeQ==",
  "subCode": "",
  "subMsg": ""
}

Delete Device Group

Interface Description

Delete device group.

Interface Method

tracker.deviceGroup.delete

Request Parameter

Name	Type	Required	Description	Example
userGroupId	int	Yes	Device group id	203

Return Data

Name	Type	Required	Description	Example
data	bool	Yes	true: Success; false: Failed	true

Example for Requesting Parameter

{
  "appId": 658409073956360262328652394,
  "method": "tracker.deviceGroup.delete",
  "format": "JSON",
  "charset": "UTF-8",
  "signType": "RSA2",
  "timestamp": "1747636484334",
  "version": "1.0",
  "bizContent": {
    "userGroupId": 203
  },
  "sign": "WXz8Ue7BOn6DrJUNFNUNZzvemhR4eMUQNTUW9prFvkshNw1OzFseTfcUzAqK7qHJcu4rEzJLfwUanM8iZiVW8fYPQHEb6GZ+0i/AMIQIXeg1TIumcC01e6/v613JlDLMksn3zucNscpLbKhZEHCQughvBnt4hTUNqZkBChCE2jGdX5smZD0uXaQLnAwKIaTqE8AvLPzW+DtARW7tho5DICsbaEN8HRVcCFQiMOZ4F7giySThrmKnU63cHtCC9ygxks+WMsVxZODljQ5792UIPaLrnY3RU8W41VJ5HmU91vDZ45aZR8fvqb5qMEh0nBO4gLiwdWN4RDldoNCqArhhmw=="
}

Example for Returning Data

{
  "code": "0",
  "data": true,
  "msg": "success",
  "sign": "eAnF+imkUl+PQSOKAT4d01WSpCg+qH2a/ai/QqDbzoGiMMAAduoXGj36aTbs0iM7WEvoCrqwrPSP7G2ASOEZVCWlCna0WK3OX15wj8JMJ1cd5USoyBo44IW0mTLHs5bTjy73yEqF/g50F1ZeJvBw+aESSji5S48oGvrH1wXaSfCTZQ5+ReL9ZHvzU2lWVSfpS9DCuQ7f6g3uYBNWKAVVeRSki95Awsv4Yiqi8SBOa2ERbXmwp6LGllBEpJNarBf5VAvHUGeDSWD2nQWPsyWceZaAfViQCYf7jdMZ8JmI6bQHrYuCnhHLAjaI84DozDGc3CadZHdgOjwsO57nz9WPeQ==",
  "subCode": "",
  "subMsg": ""
}