修改管理员车辆模型信息接口 - API 文档
修改管理员车辆模型信息接口
该接口用于根据管理员 ID 修改车辆模型信息,并提供权限验证和验证码校验功能。
请求方式: POST
请求地址: /updateOneCarModelAdminByID
请求参数:
| 参数名 | 类型 | 说明 | 必填 | |---|---|---|---| | carModelAdminId | long | 车辆模型 ID | 是 | | carModelName | string | 车辆模型名称 | 否 | | carProfile | string | 车辆模型简介 | 否 | | model | string | 车辆模型 | 否 | | year | string | 车辆年份 | 否 | | frontAerialBeforeDistance | integer | 前置天线前方距离 | 否 | | frontAerialLeftDistance | integer | 前置天线左侧距离 | 否 | | frontAerialRightDistance | integer | 前置天线右侧距离 | 否 | | behindAerialAfterDistance | integer | 后置天线后方距离 | 否 | | behindAerialLeftDistance | integer | 后置天线左侧距离 | 否 | | behindAerialRightDistance | integer | 后置天线右侧距离 | 否 | | behindAerialHeight | integer | 后置天线高度 | 否 | | phone | string | 手机号码 | 是 | | code | string | 验证码 | 是 |
请求示例:
{
"carModelAdminId": 1,
"carModelName": "宝马 X5",
"carProfile": "宝马 X5 简介",
"model": "宝马 X5",
"year": "2023",
"frontAerialBeforeDistance": 10,
"frontAerialLeftDistance": 20,
"frontAerialRightDistance": 30,
"behindAerialAfterDistance": 40,
"behindAerialLeftDistance": 50,
"behindAerialRightDistance": 60,
"behindAerialHeight": 70,
"phone": "13800000000",
"code": "123456"
}
响应参数:
| 参数名 | 类型 | 说明 | |---|---|---| | code | integer | 状态码 | | message | string | 状态信息 | | data | object | 数据对象 |
响应示例:
{
"code": 200,
"message": "成功",
"data": {}
}
注意事项:
- 请求参数中所有值为 null 的字段,将被视为未修改,保持原值。
- 验证码校验逻辑:
- 后端根据 phone 生成唯一 uuid 并存入 Redis。
- 将 uuid 和 phone 作为 key 生成验证码并存入 Redis。
- 前端提交验证码时,将 uuid 和 phone 作为 key 从 Redis 获取验证码进行校验。
- 接口会校验管理员权限,token 为 null 或空字符串则会返回权限不足错误。
- 修改成功后,会通知游戏端更新车辆模型信息。
- 验证码错误或失效会返回 CODE_FALSE 错误。
- 修改失败会返回 FAIL 错误。
原文地址: https://www.cveoy.top/t/topic/oDH1 著作权归作者所有。请勿转载和采集!