1.URL

http://124.223.60.234:8080/system/maintenance/service/updateMaintenanceService

2.请求参数

2.1请求头

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

2.2.参数示例

{
    "autoId":123265,
    "serviceTypeId": "C647C6DC090E479395D4FDB94C07496F",
    "supplierId": "41415068A1434A258ABE0AA22FB361AD",
    "occurrence": 0,
    "status": 0,
    "dateTime": "2025-11-13 00:00:00",
    "serverName":"xxxxxxxx",
    "vehicleId": "BB265AAF08ED407CBFE6E295328EA766",
    "mileage": 125.5,
    "engineHours": 0
    "invoiceNum": "545454SSVC5656",
    "descInfo": "ssssssssssssssssssss",
    "attachmentFiles": "",
    "workInfos": "[{\"id\":\"4C1BA7C87D2D48A3BA80DF0200A526CE\",\"count\":2,\"price\":30.00},{\"id\":\"DF29C1ADA353496084C5110BC36DAC2C\",\"count\":2,\"price\":30.00}]",
    "partInfos": "[{\"id\":\"12D109E9EF9D4BBC88F8293A52556F17\",\"count\":2,\"price\":30.00},{\"id\":\"44B54D74E38343A08B883D3AD93364E3\",\"count\":2,\"price\":40.00}]",
    "reminderList": [{
        "reminderName": "Oil Change",
        "nextReminder": "{\"dateTime\":\"2025-12-13\",\"mileage\":5000,\"motorHours\":6000}",
        "repeatInterval": "{\"interval\":6,\"unitType\":3,\"mileage\":6000,\"motorHours\":2000}",
        "notifyBefore": "{\"interval\":2,\"unitType\":2,\"mileage\":500,\"motorHours\":200}",
        "subscribers": "[{\"type\":0},{\"type\":1,\"emailList\":[\"leave_iot@163.com\",\"leaveiot@163.com\"]}]"
    }]
}

2.3.参数说明

字段 类型 说明 是否必须
autoId Long 服务Id Y
serviceTypeId String 服务类型唯一标识 Y
supplierId String 供应商唯一标识 Y
occurrence Integer 执行次数(0:单次服务;1:周期服务) Y
status Integer 状态(默认为 0; 0 - 待处理、1 - 已完成) Y
dateTime String 业务发生时间,格式为 “yyyy-MM-dd HH:mm:ss” Y
serverName String 服务名称 Y
vehicleId String 资产唯一标识 Y
mileage String 当时的里程值 Y
engineHours String 当时的发动机工作时长 Y
invoiceNum String 发票编号,唯一标识一张发票 Y
descInfo String 业务描述信息,用于记录业务相关备注、说明等 Y
attachmentFiles String 附件文件URL,多个URL的JSON字符串 N
workInfos String 工作项信息列表,JSON 格式字符串。存储工作项 ID、数量、单价等信息 Y
workInfos.id String 工作项唯一标识
workInfos.count Integer 工作项数量 Y
workInfos.price Double 工作项单价 Y
partInfos String 配件信息列表,JSON 格式字符串。存储配件 ID、数量、单价等信息 Y
partInfos.id String 配件唯一标识 Y
partInfos.count Integer 配件数量 Y
partInfos.price Double 配件单价 Y
reminderList Array 提醒任务列表,存储需要执行的提醒规则、下次提醒时间等信息 Y
reminderList.reminderName String 提醒名称(如 “Oil Change - 换油提醒”) Y
reminderList.nextReminder String 下次提醒信息,JSON 格式字符串。包含下次提醒时间(dateTime)、里程(mileage)、发动机时长(motorHours) Y
reminderList.repeatInterval String 重复提醒间隔,JSON 格式字符串。interval - 间隔数值;unitType - 时间单位(如 3 - 月);mileage - 里程间隔;motorHours - 发动机时长间隔 Y
reminderList.notifyBefore String 提前通知配置,JSON 格式字符串。interval - 提前数值;unitType - 时间单位(如 2 - 天);mileage - 提前里程;motorHours - 提前发动机时长 Y
reminderList.subscribers String 订阅人列表,JSON 格式字符串。type - 订阅类型(0 - 默认订阅人,1 - 指定邮箱订阅人);emailList - 指定订阅人邮箱数组(仅 type=1 时生效) Y

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": null
}

3.2.返回结果说明

字段 类型 说明
code int 返回状态
message String 返回结果描述
data object 返回结果体
Author:admin  Create time:2025-11-13 16:19
Last editor:admin  Update time:2025-11-24 14:17