User Device Page
Interface Description
Obtain the user device page based on the query conditions.
Interface Method
tracker.userDevice.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 |
| deviceCode | string | No | Device code | 250700097T |
Return Data
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| userDeviceTripId | int | Yes | Device trip ID | 2465 |
| deviceCode | string | Yes | Device code | 250700097T |
| userDeviceId | int | Yes | Device ID | 635 |
| useType | int | Yes | Usage type 0: Single use 1: Multi use | 1 |
| bindTime | long | Yes | Binding time, Millisecond-level timestamp | 1747703606652 |
| battery | int | No | Battery | 100 |
| batteryTime | long | No | Battery time, Millisecond-level timestamp | 1747703606652 |
| customName | string | No | User-defined device name | Fresh Tracker10 |
| longitude | double | No | Longitude, with a maximum of 6 decimal places | 113.812267 |
| latitude | double | No | Latitude, with a maximum of 6 decimal places | 34.481162 |
Example for Requesting Parameter
{
"appId": "658409073956360262328652394",
"method": "tracker.userDevice.page",
"format": "JSON",
"charset": "UTF-8",
"signType": "RSA2",
"timestamp": "1747703985744",
"version": "1.0",
"bizContent": {
"pageNum": 1,
"pageSize": 10
},
"sign": "d4o0+QcsnK1LKhKUK/qabA0DCD4TZs7S8jtabsKWXfUkeeWrPbsJK9eaWk9opoWyj5cUcuB6YEd3vk9l64e2ptRkjHMfi8HXZGNOAsqRKwY0hpXLmHNrBjQWg3oJXvefnIwlDFlALounKs+zKfGZfIpOcwiXqtvYTJvLZo/LygSg7Z/dD+zwEz2ah4JZhxcAm+D+Ea3mNANTfAjknwt73Anary4qV0h5Pnn/ltwpwp9pC9uK0c7hGQYCm6oM3LHwjnVYRveNeiQlLf4C0nIGPnpcMMXCy0fI8Ur+VqYGosCCuqbmSQAY/"
}
Example for Returning Data
{
"code": "0",
"data": {
"total": 1,
"rows": [
{
"bindTime": 1747703606652,
"customName": "Fresh Tracker10",
"userDeviceId": 723,
"userDeviceTripId": 2465,
"useType": 1,
"deviceCode": "250700097T",
"latitude": 34.481162,
"longitude": 113.812267,
"battery": 100,
"batteryTime": 1747703606652
}
]
},
"msg": "success",
"sign": "g9xbFi9ckQg1OfYfMDwyGFJIXxyXMB2ilLCQUpG8eLmp4MCbxu9eD8JMKtW6mXCt+rL9+wQLNa9B5+TkSTwPYZtFMhjGXZ07X5vvQYqtcQFobkK4Q0CE1Eh1xuq+yzmmSBomivj6vX0w28JinGHKRYxkc1w1MgGk8l4PYD00h9NaUYvOYEoWCnGqghJ60YXCQdQ4zrxZwJEnlfab+SZCEnD/lIBG2uL5gqBdksTqFx76mgKrbQ7NQbfZSHnRnVq3UsTGp13HUBNf92w9f/E2m0aDYvYLblDEgSYU4CHKT9h0oX622CuUe+BKhqO1UOsvy8crhw7YtVJMLE5P5Di+Yw==",
"subCode": "",
"subMsg": ""
}
Obtain User Device
Interface Description
Obtain device information based on device ID.
Interface Method
tracker.userDevice.get
Request Parameter
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| userDeviceId | int | Yes | Device ID | 635 |
Return Data
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| deviceInfo | object | Yes | Device information | |
| deviceInfo.userDeviceId | int | Yes | Device ID | 726 |
| deviceInfo.deviceCode | string | Yes | Device code | 200700097T |
| deviceInfo.deviceStatus | string | Yes | Device status online: Online offline: Offline | offline |
| deviceInfo.customName | string | No | User-defined device name | Fresh Tracker10 |
| deviceInfo.userDeviceTripId | int | No | Device trip ID | 564 |
| deviceInfo.useType | int | Yes | Usage type 0: Single use 1: Multi use | 1 |
| lightFlag | int | Yes | Light detection 0: Not supported 1: Supported | 1 |
| shockFlag | int | Yes | Vibration detection 0: Not supported 1: Supported | 1 |
| gpsFlag | int | Yes | gps positioning 0: Not supported 1: Supported | 1 |
| wifiFlag | int | Yes | WiFi positioning 0: Not supported 1: Supported | 1 |
| inProbeProperty | int | Yes | Built-in probe property-the absence of this field indicates that it is not supported. 0: Temperature 1: Temperature and humidity | 1 |
| extProbeProperty | int | Yes | External probe property-the absence of this field indicates that it is not supported. 0: Temperature 1: Temperature and humidity | 1 |
| battery | int | No | Battery | 100 |
| batteryTime | long | No | Battery time, Millisecond-level timestamp | 1747703606652 |
| inAlarmLimit | object | No | Configurable temperature and humidity limit of the built-in sensor | |
| inAlarmLimit.lowHumidity | double | No | Low humidity limit | 0 |
| inAlarmLimit.highHumidity | double | No | High humidity limit | 100 |
| inAlarmLimit.highTemperature | double | No | High temperature limit | 70 |
| inAlarmLimit.lowTemperature | double | No | Low temperature limit | -30 |
| extAlarmLimit | object | No | Configurable temperature and humidity limit of the external probe | |
| extAlarmLimit.lowHumidity | double | No | Low humidity limit | 0 |
| extAlarmLimit.highHumidity | double | No | High humidity limit | 100 |
| extAlarmLimit.highTemperature | double | No | High temperature limit | 200 |
| extAlarmLimit.lowTemperature | double | No | Low temperature limit | -200 |
Example for Requesting Parameter
{
"appId": "658409073956360262328652394",
"method": "tracker.userDevice.get",
"format": "JSON",
"charset": "UTF-8",
"signType": "RSA2",
"timestamp": "1747724083178",
"version": "1.0",
"bizContent": {
"userDeviceId": 726
},
"sign": "OdSDCbM9w+ty+bwNgXxm2/60Cy1RYjkz+jS8kB2oxyvhWW+gm43znC2e2fmJ9OQiqQcqMeCneZWEHnqZaeUyKI0YqYI88oGCnszGHZ8HN1/FsYMXoY5W0oWRVo/NfgXLCXkdRUMrSzlcRyJttoeT+3qQTUc2VZvT1Gwg7fl3rUnteIgdtjs+w2dJr9zPiAKnXc65TzzF6l/j4yzXIpIBYRbp8JATA2LblVA3rhtAf30xtpxcyPFBG2q3ZQiBlYSyGjq7YTigozKHMfYxFdIMmb8Br9ghi+LIwRcksoQR5o14SbfxNeohA+myv6+StyoSLoncAUABtZ1Q1VjYF0qAug=="
}
Example for Returning Data
{
"code": "0",
"data": {
"inAlarmLimit": {
"lowHumidity": 0,
"highHumidity": 100,
"highTemperature": 70,
"lowTemperature": -30
},
"gpsFlag": 1,
"wifiFlag": 0,
"extProbeProperty": 1,
"inProbeProperty": 1,
"battery": 100,
"batteryTime": 1747703606652,
"lightFlag": 1,
"shockFlag": 1,
"deviceInfo": {
"customName": "Tracker10",
"deviceCode": "200700097T",
"userDeviceId": 726,
"deviceStatus": "offline"
},
"extAlarmLimit": {
"lowHumidity": 0,
"highHumidity": 100,
"highTemperature": 200,
"lowTemperature": -200
}
},
"msg": "success",
"sign": "SQl+j39JYSIuu/J3YaeG3p30krDXOBcwjT0c3vkPvxQV6FxEEghvzQcz4xaZsWFhvltHA3aga/VLTlrXxBdx09AikdOtfArKw7m1bB+QZcLbjn4EzyzIbiSetWK/pjmAveOsiZIiSUbT3cLJkBQRTBZl0sRBvlReFGbYgnZlyI3swgaib2+CgPgVYaJxaX8ePx7EKydCeXeZCsUQjVxCLdaPO+4a7QRFvWTx7fWulJwc1bEaHLEzgotOvRbK+gTQTH24NsdSP9C/Nz9LYUEETyBb5zhD+l7W7OirRXtk8iKnsGFX6EPdQSxQDO3QRRbRBR3km60UsyupfuROhUcZAw==",
"subCode": "",
"subMsg": ""
}