FreshlianceFreshliance
Tracker文档
网关文档
  • English
  • 简体中文
Tracker文档
网关文档
  • English
  • 简体中文
  • API介绍

    • 概述
    • 参数
    • 签名
    • 规则
    • 错误码
  • API列表

    • 用户信息
    • 用户设备
    • 设备行程
    • 行程数据
    • 设备分组
    • 分组设备
    • 配置模板
  • Webhook介绍

    • Webhook

分组已分配设备分页

接口说明

根据查询条件获取已分配给分组的设备分页

接口方法

tracker.groupDevice.pageAllocatedDevice

请求参数

名称类型必选描述示例值
pageNumint是页数,从 1 开始1
pageSizeint是每页数量,大小为 1-50 条10
userGroupIdint是分组 ID125
deviceCodestring否设备标识250700097T
tripCodestring否运单编号tripCode
deviceStatusstring否设备状态
online:在线
offline:离线
online

返回数据

名称类型必选描述示例值
totalint是总数量1
rowsarray[object]是数据列表
rows.userGroupDeviceIdint是用户群组设备 id646
rows.userDeviceIdint是用户设备 id686
rows.deviceCodestring是设备编码200700090T
rows.deviceTypestring是设备类型Tracker10
rows.tripStatusstring是行程单状态
wait:待开始
ing:运输中
end:已结束
ing
rows.alarmFlagint是行程报警标记
0:未报警
1:已报警
0
rows.deviceStatusstring是设备状态
online:在线
offline:离线
offline
rows.customNamestring否设备自定义名称orange
rows.tripCodestring否运单编号tripCode
rows.goodsNamestring否货物名称orange
rows.expectedBeginTimelong否预期起始时间1747640566191
rows.expectedEndTimelong否预期截止时间1747640588653

请求示例

{
  "appId": 658409073956360262328652394,
  "method": "tracker.groupDevice.pageAllocatedDevice",
  "format": "JSON",
  "charset": "UTF-8",
  "signType": "RSA2",
  "timestamp": "1747640566191",
  "version": "1.0",
  "bizContent": {
    "pageNum": 1,
    "pageSize": 10,
    "userGroupId": 186
  },
  "sign": "b5hjSZwQR0Vw014fKfremt9SMhDbCOCna3QcR3VjlC9/2NEuexwUNgJeuwb3FrRkQNUvI52GHMA+3nTfoqZQElGdwR8+ysBcBX86XLwnJhi3G6SZZdJjXqImhXDJlY0fuh85eHly9dxlSuEcp23AYOZevYdWcFzdg8Yl43dKFfrr4+joBWI4vk/mDBTZYx0hCN1x6mS1ArQmeu3vzhHP3qzd6qjoenlIFOI0wusdfE4T91V+OW6a/zI5lS4cwMPJzTcmJo/gx9ARdt0Ogw4N+d2Jp+6BOow1reEWrIwWvT+gV+czvyYVwwX1Yaa4WSTR/d9Ut9fE1a3k4r7X8OlkEg=="
}

返回示例

{
  "code": "0",
  "data": {
    "total": 2,
    "rows": [
      {
        "deviceType": "Tracker10",
        "customName": "Fresh Tracker10",
        "deviceCode": "240701311T",
        "userDeviceId": 533,
        "alarmFlag": "0",
        "deviceStatus": "offline",
        "tripCode": "pearCode",
        "userGroupDeviceId": 636,
        "goodsName": "pear",
        "tripStatus": "ing",
        "expectedBeginTime": 1747640566191,
        "expectedEndTime": 1747640588653
      },
      {
        "deviceType": "Tracker10-ETU",
        "customName": "Fresh Tracker10-ETU",
        "deviceCode": "240701298T",
        "userDeviceId": 713,
        "alarmFlag": "1",
        "deviceStatus": "offline",
        "tripCode": "",
        "userGroupDeviceId": 635,
        "goodsName": "",
        "tripStatus": "ing",
        "expectedBeginTime": 1747640566191,
        "expectedEndTime": 1747640588653
      }
    ]
  },
  "msg": "success",
  "sign": "gF5yKGAbfvN8ubMnPGQPaNHKqd2j2esecgSy64GDUVZwXle7TYbRVlqwPPzkF9yRu1EuNPRp9kKFOAgQdKIiCMOVjLqQqDPGLDxgpnJwlAzI88xunQmTSEsmiVEmtSFao9qCFszwjLj0f5eaDj9dnqxgMN2FDfCozEfDvDMqdrAGCCEJSFF6fsOGs1wiQC2s2Olbhld+Cs57XuA36s2pk7KVz58T4dqqRBdktH+qmmZFNQykOob8YTGhfqgx7HVzyTLeC4Fd9nilWcvhblV8SaRbCq76VEdAWGP/un/ABTYabIAxP00p8ryyQ8h66S24Q5emWpRgbDNl+vS/0kyBag==",
  "subCode": "",
  "subMsg": ""
}

分组未分配设备分页

接口说明

根据查询条件获取未分配给分组的设备分页

接口方法

tracker.groupDevice.pageUnAllocatedDevice

请求参数

名称类型必选描述示例值
pageNumint是页数,从 1 开始1
pageSizeint是每页数量,大小为 1-50 条10
userGroupIdint是分组 ID125
deviceCodestring否设备标识250700097T

返回数据

名称类型必选描述示例值
totalint是总数量1
rowsarray[object]是数据列表
rows.userDeviceIdint是用户设备 id646
rows.deviceStatusstring是设备状态
online:在线
offline:离线
offline
rows.alarmFlagint是行程报警标记
0:未报警
1:已报警
0
rows.deviceTypestring是设备类型Tracker10
rows.deviceCodestring是设备标识200700090T
rows.customNamestring否用户自定义设备名称Fresh Tracker10
rows.tripCodestring否运单编号orangeCode
rows.tripStatusstring是行程单状态
wait:待开始
ing:运输中
end:已结束
ing
rows.goodsNamestring否货物名称orange
rows.expectedBeginTimelong否预期起始时间1747640566191
rows.expectedEndTimelong否预期截止时间1747640588653

请求示例

{
  "appId": 658409073956360262328652394,
  "method": "tracker.groupDevice.pageUnAllocatedDevice",
  "format": "JSON",
  "charset": "UTF-8",
  "signType": "RSA2",
  "timestamp": "1747640566191",
  "version": "1.0",
  "bizContent": {
    "pageNum": 1,
    "pageSize": 10,
    "userGroupId": 186
  },
  "sign": "j4P3eHX+Dct4lIp5LnLrKJsQI9MW+YhAzG0bP/W+ETb9bkABoXOCE+tpTGg+dgX1iJbAe1yzKlM9XWMHL3dhl7Y9MQRuMakndfB9JAgd4dUWVzhpv9Q5zK6wOIIpTjJBtxe//dZArsG3BeHKBc6lq/5KibsZ7vNRY2NqAxy9QeOmcCoChGrJ5Qqk/IWTVzpakwY9ioKKM3sDQMPxteyHP+k+FV+q7XiSCHK/3oWV2aIoFwnRhcbK2C2Y4JyK5n4Wr5Ghsy/Sgi6y5nXCdjzCyPE2dsbqMFB0H1I4K79lxKedQQzHcExsNCMEUXHaiRMI0tceU65UCAqxzhBb5WGN1Q=="
}

返回示例

{
  "code": "0",
  "data": {
    "total": 1,
    "rows": [
      {
        "deviceType": "Tracker10",
        "customName": "Fresh Tracker10",
        "deviceCode": "200700082T",
        "userDeviceId": 716,
        "alarmFlag": "0",
        "deviceStatus": "offline",
        "tripCode": "123",
        "goodsName": "orange",
        "tripStatus": "end",
        "expectedBeginTime": 1747640566191,
        "expectedEndTime": 1747640588653
      }
    ]
  },
  "msg": "success",
  "sign": "hDRDjqSgZojnEgVgeI5h9oxFUCXtg4lryJDneGy77qSqkiGB1SoPQSBbnB91Igwlk2G2+OA9mlvNsqgYh5ad5/VRNOjMBi+xq5/TIJzrrRNqveXcyb+2JjQIRDMIb4wVumYreq6HDHnlAhWeoNdFEEdz5b6Str06tbepAyREayz8o3d0u2xc9WGqAeiRI7bzqvbf7z0lXW04yMN9zCFqcCfgEmrWqxvRqrMx180Qz/syONJH7LBh+5YNDvOXsGktG8JdcjI1uRhCzK2fh5qWIGJYL0gykfH9ukUiS42xc4TIjvAxN4FpCnXvg4z3LOcvMQLoJyqr7HgGlouHV4qMzA==",
  "subCode": "",
  "subMsg": ""
}

分组解绑设备

接口说明

分组解绑设备

接口方法

tracker.groupDevice.unbindDevice

请求参数

名称类型必选描述示例值
userGroupDeviceIdListarray[int]是用户分组设备 id 列表[635]

返回数据

名称类型必选描述示例值
databool是true 删除成功 false 删除失败true

请求示例

{
  "appId": 658409073956360262328652394,
  "method": "tracker.groupDevice.unbindDevice",
  "format": "JSON",
  "charset": "UTF-8",
  "signType": "RSA2",
  "timestamp": "1747645671183",
  "version": "1.0",
  "bizContent": {
    "userGroupDeviceIdList": [645],
    "userGroupId": 186
  },
  "sign": "Psbn5gxDHI2mmJEezUmL0RnEfT3ty0ui9fQNm1wLV9CJbBr8QnExZw4rETK1aCOn6jSppDEwhbhKlpYa1dNZaMdALLvonwAIgUSMCt1LC0lFx+OAVjqQJ70wCNt4cUzcltaVAisSL7TZaabBgztSjDGgKPEsVKjEWOyDDbh7wZUWApRKYudErkhuOZhu4qLXlp7ZamtzSQzA2xc3xPtDTPUD1KqgpbnEosS2CtL+NewA4eeLCP/CXntIuUUie81wYl4Llvo5Er0i+1imFxMcYQnX5sOvOKIE635zRB9BoniUaWjqysHNDhTH0pwcBbv7A1/W7KximGwEEXkEHEGyDw=="
}

返回示例

{
  "code": "0",
  "data": true,
  "msg": "success",
  "sign": "JTbz7QTYiTDKkLpCipwMmx2GK2TGM7YCVg1rtq+btve1zi/tv2qkAQ54xPmzpu3IMr0DiZ++7QT62Kpf7lmW4pePxjt9nEvM/rFy7+/OX0qKTvzoWPYup+DcMnZ1FNcseS6H6BTx83BGKp406HWBT0K1i/0v3hJTphWKnzrDAAZfgCKf5ieu2DrwGHLeRnR99Snk6ocmiE9t3fJN1u11W8+KCHQDQbL7x4NsRae6VsMP63v4lDbVtTcu2wpLOExwwzqFk4IVoJbEUU0VnyhzVoOrGzOxJpG7huoYOkyn9c740/5f7LD2Zk/8RCRPHHl29g1QmOsqk4JkKiO3M0ECIw==",
  "subCode": "",
  "subMsg": ""
}

分组绑定设备

接口说明

分组绑定设备

接口方法

tracker.groupDevice.bindDevice

请求参数

名称类型必选描述示例值
userDeviceIdListarray[int]是用户设备 id 列表[635]
userGroupIdint是用户分组 id186

返回数据

名称类型必选描述示例值
databool是true 删除成功 false 删除失败true

请求示例

{
  "appId": 658409073956360262328652394,
  "method": "tracker.groupDevice.bindDevice",
  "format": "JSON",
  "charset": "UTF-8",
  "signType": "RSA2",
  "timestamp": "1747642861194",
  "version": "1.0",
  "bizContent": {
    "userDeviceIdList": [635],
    "userGroupId": 186
  },
  "sign": "WYu7DvBTRuL0eWqNlKKzaQED24OmOEC5MPAnrxnoD0J7g8t9SzCUmXyZTgclReYW2qJWCESAkbW5L7qLlwwsPucb0k68WxCNwFB9FitOAalrXA6cOewBtsTmK0a8Upr0TESQYftSshQ/ZUbQLsEMTwNIPMtjiFfXrtHlaF78P/HVq0jV40mworgCAvDsLX/kXNvGZUluwn8iqw4l/mjsA7CppcFMSY/+r8SQTCQ5pCW8cGp0RNsVtdtR7x47V70Jl12g+GHbTMMebn72ejSM2VwjhV5HARK6KZfTx4ey/fJNUcHE07XAB8PvQnd9uSI1PFzixg7XUvMeOjGfUjOpqg=="
}

返回示例

{
  "code": "0",
  "data": true,
  "msg": "success",
  "sign": "eAnF+imkUl+PQSOKAT4d01WSpCg+qH2a/ai/QqDbzoGiMMAAduoXGj36aTbs0iM7WEvoCrqwrPSP7G2ASOEZVCWlCna0WK3OX15wj8JMJ1cd5USoyBo44IW0mTLHs5bTjy73yEqF/g50F1ZeJvBw+aESSji5S48oGvrH1wXaSfCTZQ5+ReL9ZHvzU2lWVSfpS9DCuQ7f6g3uYBNWKAVVeRSki95Awsv4Yiqi8SBOa2ERbXmwp6LGllBEpJNarBf5VAvHUGeDSWD2nQWPsyWceZaAfViQCYf7jdMZ8JmI6bQHrYuCnhHLAjaI84DozDGc3CadZHdgOjwsO57nz9WPeQ==",
  "subCode": "",
  "subMsg": ""
}
Prev
设备分组
Next
配置模板