用户设备 | Freshliance

用户设备分页

接口说明

根据查询条件获取用户设备分页

接口方法

tracker.userDevice.page

请求参数

名称	类型	必选	描述	示例值
pageNum	int	是	页数,从 1 开始	1
pageSize	int	是	每页数量,大小为 1-50 条	10
deviceCode	string	否	设备标识	250700097T

返回数据

名称	类型	必选	描述	示例值
userDeviceTripId	int	是	用户设备行程 ID	2465
deviceCode	string	是	设备标识	250700097T
userDeviceId	int	是	用户设备 ID	635
useType	int	是	使用类型 0:单次 1:多次	1
bindTime	long	是	绑定时间,毫秒级时间戳	1747703606652
battery	int	否	电量	100
batteryTime	long	否	电量时间, 毫秒级时间戳	1747703606652
customName	string	否	用户自定义设备名称	Fresh Tracker10
longitude	double	否	经度,最大 6 位小数	113.812267
latitude	double	否	纬度,最大 6 位小数	34.481162

请求示例

{
  "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/"
}

返回示例

{
  "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": ""
}

获取用户设备

接口说明

根据用户设备 ID 获取设备信息

接口方法

tracker.userDevice.get

请求参数

名称	类型	必选	描述	示例值
userDeviceId	int	是	用户设备 ID	635

返回数据

名称	类型	必选	描述	示例值
deviceInfo	object	是	设备信息
deviceInfo.userDeviceId	int	是	用户设备 ID	726
deviceInfo.deviceCode	string	是	设备标识	200700097T
deviceInfo.deviceStatus	string	是	设备状态 online:在线 offline:离线	offline
deviceInfo.customName	string	否	用户自定义设备名称	Fresh Tracker10
deviceInfo.userDeviceTripId	int	否	行程单 ID	564
deviceInfo.useType	int	是	使用类型 0:单次 1:多次	1
lightFlag	int	是	设备支持光照检测情况 0:不支持 1:支持	1
shockFlag	int	是	设备支持震动检测情况 0:不支持 1:支持	1
gpsFlag	int	是	设备支持 gps 定位情况 0:不支持 1:支持	1
wifiFlag	int	是	设备支持 wifi 定位情况 0:不支持 1:支持	1
inProbeProperty	int	是	内置探头属性未出现此字段表示不支持 0:单温 1:温湿	1
extProbeProperty	int	是	外置探头属性未出现此字段表示不支持 0:单温 1:温湿	1
battery	int	否	电量	100
batteryTime	long	否	电量时间, 毫秒级时间戳	1747703606652
inAlarmLimit	object	否	内置温湿度可设置上下限
inAlarmLimit.lowHumidity	double	否	最低湿度	0
inAlarmLimit.highHumidity	double	否	最高湿度	100
inAlarmLimit.highTemperature	double	否	最高温度	70
inAlarmLimit.lowTemperature	double	否	最低温度	-30
extAlarmLimit	object	否	外置温湿度可设置上下限
extAlarmLimit.lowHumidity	double	否	最低湿度	0
extAlarmLimit.highHumidity	double	否	最高湿度	100
extAlarmLimit.highTemperature	double	否	最高温度	200
extAlarmLimit.lowTemperature	double	否	最低温度	-200

请求示例

{
  "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=="
}

返回示例

{
  "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": ""
}