1.URL

http://124.223.60.234:8080/system/asset/report/analysis/queryDriverBehaviorReport

2.请求参数

2.1请求头

在Headers里面增加token:对应登录验证成功后，data里面对应的tokenId

2.2.参数示例

2.2.1 查询字段

{
    "ids": 
["13EF6935C29844DEB3D3B8B8F6CFF3DC", "B705D039C3564878B5F5261D84A0C376","C4038EF8030B4FC5B735869BA5348644","B11775880D5146178F180766A9CFDC67"],
    "startTime":"2025-09-08 16:00:00",
    "endTime":"2025-09-15 16:00:00",
    "pageNum":1,
    "pageSize":20
}

2.2.参数说明

字段 类型 说明 是否必须
ids List 司机唯一标识集合 Y
startTime String 开始时间（UTC） Y
endTime String 结束时间（UTC） Y
pageNum int 当前页 Y
pageSize int 每页显示的条数 Y

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 7,
        "size": 1,
        "data": [
            {
                "driverId": "3DF1997CA6B84EC7B79C8D01DFC1A1CC",
                "driverName": "No iqama details",
                "driverPhone": "",
                "driverEmail": "",
                "orgId": "4A15C26154294247A42A50B5254243B1",
                "orgName": "Al Osais Contracting Company",
                "vehicleId": "D192682F800A4F13ACAB94E597B5162A",
                "vehicleNum": "7914 TJR",
                "terminalId": "CD684A0E0009485FB6BC0EE4E5240A71",
                "terminalNum": "864275075021108",
                "customNum": "1108",
                "totalTrip": 7,
                "harshBrakes": 0,
                "harshAccel": 5444,
                "harshTurn": 0,
                "totalEvent": 5444,
                "threshold": 777.7142857142857,
                "riskRating": "{\"0\":\"High\",\"1\":\"高\",\"2\":\"Alto\",\"3\":\"عالي\"}",
                "riskNotes": "{\"0\":\"Critical – requires training\",\"1\":\"紧急 —— 需要培训\",\"2\":\"Crítico: requiere entrenamiento\",\"3\":\"حاسم – يتطلب التدريب\"}",
                "riskActions": "{\"0\":\"Unsafe driving trend. Immediate corrective action/training required.\",\"1\":\"不安全的驾驶趋势。需要立即采取纠正措施 / 培训。\",\"2\":\"Tendencia de conducción insegura. Se requieren medidas correctivas/training inmediatas.\",\"3\":\"نزعة قيادة غير آمنة. مطلوبة إجراءات تصحيحية فورية/تدريب.\"}"
            },
            {
                "driverId": "27D208E2A8304D2ABE5A60914D65CCAE",
                "driverName": "No details of id",
                "driverPhone": "",
                "driverEmail": "",
                "orgId": "4A15C26154294247A42A50B5254243B1",
                "orgName": "Al Osais Contracting Company",
                "vehicleId": "8B46473D08C74192894A2DBB9D2F135D",
                "vehicleNum": "5700 DGR",
                "terminalId": "06553C832FFE4B0BAAC991E1CDC420B6",
                "terminalNum": "864275071780475",
                "customNum": "0475",
                "totalTrip": 8,
                "harshBrakes": 0,
                "harshAccel": 0,
                "harshTurn": 0,
                "totalEvent": 0,
                "threshold": 0.0,
                "riskRating": "{\"0\":\"Low\",\"1\":\"低\",\"2\":\"Bajo\",\"3\":\"درجة منخفضة\"}",
                "riskNotes": "{\"0\":\"Acceptable\",\"1\":\"可接受\",\"2\":\"Aceptable\",\"3\":\"مقبول\"}",
                "riskActions": "{\"0\":\"Safe driving, within tolerance. No action needed.\",\"1\":\"安全驾驶，在容忍范围内。无需采取行动。\",\"2\":\"Conducción segura, dentro de la tolerancia. No es necesario tomar medidas.\",\"3\":\"قيادة آمنة، ضمن الحد المسموح به. لا يحتاج إلى أي إجراء.\"}"
            },
            {
                "driverId": "4A48E4C4394B4ABCA20915F48DC37EF5",
                "driverName": "Waqar Shaheen Nawaz Ali",
                "driverPhone": "2292879349",
                "driverEmail": "",
                "orgId": "51ED874CF3014BB89B8CC7ED750B52A3",
                "orgName": "CAT ",
                "vehicleId": "457ACE3BE2DE4AA0ABAC2BEB1AD0421D",
                "vehicleNum": "156347",
                "terminalId": "52767386DF3A4C2DA075131CC9489803",
                "terminalNum": "55000138591",
                "customNum": "8591",
                "totalTrip": 1,
                "harshBrakes": 0,
                "harshAccel": 0,
                "harshTurn": 0,
                "totalEvent": 0,
                "threshold": 0.0,
                "riskRating": "{\"0\":\"Low\",\"1\":\"低\",\"2\":\"Bajo\",\"3\":\"درجة منخفضة\"}",
                "riskNotes": "{\"0\":\"Acceptable\",\"1\":\"可接受\",\"2\":\"Aceptable\",\"3\":\"مقبول\"}",
                "riskActions": "{\"0\":\"Safe driving, within tolerance. No action needed.\",\"1\":\"安全驾驶，在容忍范围内。无需采取行动。\",\"2\":\"Conducción segura, dentro de la tolerancia. No es necesario tomar medidas.\",\"3\":\"قيادة آمنة، ضمن الحد المسموح به. لا يحتاج إلى أي إجراء.\"}"
            },
            {
                "driverId": "6DF5EC22217045DDA5123733BCB45528",
                "driverName": "Vehicle Registration 6571 ATB",
                "driverPhone": "",
                "driverEmail": "",
                "orgId": "4A15C26154294247A42A50B5254243B1",
                "orgName": "Al Osais Contracting Company",
                "vehicleId": "FA2D6D1BEBCA474B8D78A97357A85678",
                "vehicleNum": "6571 ATB",
                "terminalId": "554EA1A6C2554DABAB3B3AB696BB9C0D",
                "terminalNum": "864275073602321",
                "customNum": "2321",
                "totalTrip": 0,
                "harshBrakes": 0,
                "harshAccel": 0,
                "harshTurn": 0,
                "totalEvent": 0,
                "threshold": 0.0,
                "riskRating": "{\"0\":\"Low\",\"1\":\"低\",\"2\":\"Bajo\",\"3\":\"درجة منخفضة\"}",
                "riskNotes": "{\"0\":\"Acceptable\",\"1\":\"可接受\",\"2\":\"Aceptable\",\"3\":\"مقبول\"}",
                "riskActions": "{\"0\":\"Safe driving, within tolerance. No action needed.\",\"1\":\"安全驾驶，在容忍范围内。无需采取行动。\",\"2\":\"Conducción segura, dentro de la tolerancia. No es necesario tomar medidas.\",\"3\":\"قيادة آمنة، ضمن الحد المسموح به. لا يحتاج إلى أي إجراء.\"}"
            },
            {
                "driverId": "7142938D1E344BA38D2B0C59611AA721",
                "driverName": "Vehicle Registration 5652 DGR",
                "driverPhone": "",
                "driverEmail": "",
                "orgId": "4A15C26154294247A42A50B5254243B1",
                "orgName": "Al Osais Contracting Company",
                "vehicleId": "5612AA747C194680B0A2CFAD98E62EE6",
                "vehicleNum": "5652 DGR",
                "terminalId": "A224249F75954C218C93C0EE0E3684D3",
                "terminalNum": "864275074681407",
                "customNum": "1407",
                "totalTrip": 0,
                "harshBrakes": 0,
                "harshAccel": 0,
                "harshTurn": 0,
                "totalEvent": 0,
                "threshold": 0.0,
                "riskRating": "{\"0\":\"Low\",\"1\":\"低\",\"2\":\"Bajo\",\"3\":\"درجة منخفضة\"}",
                "riskNotes": "{\"0\":\"Acceptable\",\"1\":\"可接受\",\"2\":\"Aceptable\",\"3\":\"مقبول\"}",
                "riskActions": "{\"0\":\"Safe driving, within tolerance. No action needed.\",\"1\":\"安全驾驶，在容忍范围内。无需采取行动。\",\"2\":\"Conducción segura, dentro de la tolerancia. No es necesario tomar medidas.\",\"3\":\"قيادة آمنة، ضمن الحد المسموح به. لا يحتاج إلى أي إجراء.\"}"
            },
            {
                "driverId": "0ED9550808CA4F2DB03FB35FBFF70799",
                "driverName": "Sandeep Kumar Raj Dev",
                "driverPhone": "2564975197",
                "driverEmail": "",
                "orgId": "51ED874CF3014BB89B8CC7ED750B52A3",
                "orgName": "CAT ",
                "vehicleId": "6AFBF8A8F225467697956544BC7D4060",
                "vehicleNum": "137747",
                "terminalId": "BCB1392EE3474AABBAE58D6A0A3AF1D7",
                "terminalNum": "55000138644",
                "customNum": "8644",
                "totalTrip": 0,
                "harshBrakes": 0,
                "harshAccel": 0,
                "harshTurn": 0,
                "totalEvent": 0,
                "threshold": 0.0,
                "riskRating": "{\"0\":\"Low\",\"1\":\"低\",\"2\":\"Bajo\",\"3\":\"درجة منخفضة\"}",
                "riskNotes": "{\"0\":\"Acceptable\",\"1\":\"可接受\",\"2\":\"Aceptable\",\"3\":\"مقبول\"}",
                "riskActions": "{\"0\":\"Safe driving, within tolerance. No action needed.\",\"1\":\"安全驾驶，在容忍范围内。无需采取行动。\",\"2\":\"Conducción segura, dentro de la tolerancia. No es necesario tomar medidas.\",\"3\":\"قيادة آمنة، ضمن الحد المسموح به. لا يحتاج إلى أي إجراء.\"}"
            },
            {
                "driverId": "88E68E8285EC49338C7ED374239F4581",
                "driverName": "Vehicle Registration 3655 VTB",
                "driverPhone": "",
                "driverEmail": "",
                "orgId": "4A15C26154294247A42A50B5254243B1",
                "orgName": "Al Osais Contracting Company",
                "vehicleId": "6F5ED193D3F046D9B061DE46F15D16EE",
                "vehicleNum": "3655 VTB",
                "terminalId": "C51812AF4E9F48F0BC0E706817A29AEF",
                "terminalNum": "864275075007115",
                "customNum": "7115",
                "totalTrip": 0,
                "harshBrakes": 0,
                "harshAccel": 0,
                "harshTurn": 0,
                "totalEvent": 0,
                "threshold": 0.0,
                "riskRating": "{\"0\":\"Low\",\"1\":\"低\",\"2\":\"Bajo\",\"3\":\"درجة منخفضة\"}",
                "riskNotes": "{\"0\":\"Acceptable\",\"1\":\"可接受\",\"2\":\"Aceptable\",\"3\":\"مقبول\"}",
                "riskActions": "{\"0\":\"Safe driving, within tolerance. No action needed.\",\"1\":\"安全驾驶，在容忍范围内。无需采取行动。\",\"2\":\"Conducción segura, dentro de la tolerancia. No es necesario tomar medidas.\",\"3\":\"قيادة آمنة، ضمن الحد المسموح به. لا يحتاج إلى أي إجراء.\"}"
            }
        ]
    }
}

3.2.返回结果说明

字段 类型 说明
code int 返回状态
message String 返回结果描述
data object 返回结果体

data 详情

字段 类型 说明
total String 总条数
size String 多少页
data object 每页的结果集合

data 详情

字段 类型 说明
driverId String 司机唯一标识
driverName String 司机姓名
driverPhone String 司机电话
orgId String 组织唯一标识
orgName String 组织名称
vehicleId String 车辆唯一标识
vehicleNum String 车牌号
terminalId String 终端唯一标识
terminalNum String 终端编号
customNum String 终端自定义编号
level int 等级
totalTrip int 总行程
harshBrakes int 急刹车事件数量
harshAccel int 急加速事件数量
harshTurn int 急转弯事件数量
totalEvent int 总的事件数量
riskRating String 风险评级
riskNotes String 风险说明
riskActions String 行动建议
作者：admin  创建时间：2025-09-10 00:05
最后编辑：admin  更新时间：2025-09-15 23:19