Base URL:
http://localhost:8098/api/v1认证方式: Bearer Token(JWT)
内容类型:
application/json; charset=utf-8更新日期: 2026-04-05
成功响应
{
"code": 0,
"message": "success",
"data": { ... }
}分页响应
{
"code": 0,
"message": "success",
"data": [ ... ],
"meta": {
"page": 1,
"page_size": 20,
"total": 100,
"total_pages": 5
}
}错误响应
{
"code": 4000,
"message": "error description"
}校验错误响应 (422)
{
"code": 4220,
"message": "validation_error",
"errors": { ... }
}| HTTP 状态码 | 业务错误码 | 说明 |
|---|---|---|
| 400 | 4000 | 错误请求(参数不合法) |
| 401 | 4010 | 未认证(Token 缺失/无效/过期) |
| 403 | 4030 | 无权限 |
| 404 | 4040 | 资源不存在 |
| 409 | 4090 | 资源冲突(如邮箱已注册) |
| 422 | 4220 | 校验错误 |
| 429 | 4290 | 请求频率超限 |
| 500 | 5000 | 服务器内部错误 |
- 需认证的接口须在 Header 中携带:
Authorization: Bearer <access_token> - Access Token 有效期 15 分钟
- Refresh Token 有效期 7 天
- Token 过期后使用 Refresh Token 续期
- 全局限流:100 请求/秒/IP,突发上限 200
- 超限返回
429 Too Many Requests
POST /api/v1/auth/register
无需认证
请求体
| 字段 | 类型 | 必填 | 校验 | 说明 |
|---|---|---|---|---|
| string | ✅ | 合法邮箱 | 用户邮箱 | |
| password | string | ✅ | 8-72 字符 | 密码 |
| nickname | string | ✅ | 1-100 字符 | 昵称 |
| locale | string | - | en-US / zh-CN / ja-JP |
偏好语言 |
| invite_code | string | 视模式 | - | 邀请码(invite_only 模式下必填) |
注册模式:通过
GET /api/v1/auth/registration-mode查询当前模式。
open:公开注册,invite_code可选invite_only:必须携带有效邀请码closed:完全关闭注册,返回403 Forbidden
请求示例
{
"email": "user@example.com",
"password": "mypassword123",
"nickname": "张三",
"locale": "zh-CN",
"invite_code": "GT-A3X7K9"
}成功响应 201 Created
{
"code": 0,
"message": "success",
"data": {
"access_token": "eyJhbGciOiJIUzI1NiIs...",
"refresh_token": "dGhpcyBpcyBhIHJlZnJlc2g...",
"expires_in": 900,
"user": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "user@example.com",
"nickname": "张三",
"locale": "zh-CN",
"timezone": "UTC",
"currency_code": "USD",
"unit_system": "metric",
"fuel_efficiency_unit": "L/100km",
"status": "active",
"created_at": "2026-03-26T10:00:00Z"
}
}
}错误响应 409 Conflict(邮箱已注册)
{
"code": 4090,
"message": "email already registered"
}POST /api/v1/auth/login
无需认证
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | ✅ | 用户邮箱 | |
| password | string | ✅ | 密码 |
成功响应 200 OK
响应格式同「2.1 注册」。
POST /api/v1/auth/refresh
无需认证
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| refresh_token | string | ✅ | 刷新令牌 |
成功响应 200 OK
响应格式同「2.1 注册」(返回新的 access_token 和 refresh_token)。
Token Rotation 机制:每次刷新时,旧的 refresh token 会被原子性地消费(SELECT FOR UPDATE + DELETE),确保同一个 refresh token 只能使用一次。如果同一 refresh token 被并发使用,只有第一个请求成功,后续请求返回
401 Unauthorized。已注销的账号返回401,被停用的账号返回403。
POST /api/v1/auth/logout
🔒 需要认证
成功响应 204 No Content
(无响应体)
GET /api/v1/users/me
🔒 需要认证
成功响应 200 OK
{
"code": 0,
"message": "success",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "user@example.com",
"nickname": "张三",
"avatar_url": "https://example.com/avatar.jpg",
"locale": "zh-CN",
"timezone": "Asia/Shanghai",
"country_code": "CN",
"currency_code": "CNY",
"unit_system": "metric",
"fuel_efficiency_unit": "L/100km",
"status": "active",
"last_login_at": "2026-03-26T10:00:00Z",
"created_at": "2026-03-01T08:00:00Z"
}
}PATCH /api/v1/users/me
🔒 需要认证
请求体(所有字段均可选)
| 字段 | 类型 | 校验 | 说明 |
|---|---|---|---|
| nickname | string | 1-100 字符 | 昵称 |
| avatar_url | string | 合法 URL | 头像 URL |
| locale | string | en-US / zh-CN / ja-JP |
偏好语言 |
| timezone | string | 最长 50 字符 | 时区(如 Asia/Shanghai) |
| country_code | string | 2 字符 | ISO 3166-1 alpha-2 国家代码 |
| currency_code | string | 3 字符 | ISO 4217 货币代码 |
| unit_system | string | metric / imperial |
计量单位体系 |
| fuel_efficiency_unit | string | L/100km / km/L / MPG |
油耗单位 |
成功响应 200 OK
返回更新后的完整用户对象(格式同「3.1」)。
PUT /api/v1/users/me/password
🔒 需要认证
请求体
| 字段 | 类型 | 必填 | 校验 | 说明 |
|---|---|---|---|---|
| old_password | string | ✅ | - | 旧密码 |
| new_password | string | ✅ | 8-72 字符,且不超过 72 字节 | 新密码 |
成功响应 200 OK
响应格式同「2.1 注册」。修改成功后该用户所有设备的 refresh token 均被吊销,响应中返回当前设备的新 access_token 和 refresh_token,客户端需保存。
DELETE /api/v1/users/me
🔒 需要认证
成功响应 204 No Content
GET /api/v1/vehicles
🔒 需要认证
查询参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| include_archived | string | "false" |
是否包含已归档车辆 |
成功响应 200 OK
{
"code": 0,
"message": "success",
"data": [
{
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "家用车",
"vehicle_type": "car",
"brand": "Toyota",
"model": "Camry",
"year": 2023,
"fuel_type": "gasoline",
"tank_capacity": 60.0,
"battery_capacity": 0,
"engine_cc": 2000,
"license_plate": "京A12345",
"photo_url": "",
"is_default": true,
"is_archived": false,
"created_at": "2026-03-01T08:00:00Z",
"updated_at": "2026-03-20T12:00:00Z"
}
]
}POST /api/v1/vehicles
🔒 需要认证
请求体
| 字段 | 类型 | 必填 | 校验 | 说明 |
|---|---|---|---|---|
| name | string | ✅ | 1-100 字符 | 车辆名称 |
| vehicle_type | string | ✅ | car / motorcycle / other |
车辆类型 |
| brand | string | - | 最长 100 字符 | 品牌 |
| model | string | - | 最长 100 字符 | 型号 |
| year | int | - | 1900-2100 | 年份 |
| fuel_type | string | ✅ | gasoline / diesel / hybrid / electric |
燃油/能源类型 |
| tank_capacity | float | - | > 0 | 油箱容量(升),燃油车使用 |
| battery_capacity | float | - | > 0 | 电池容量(kWh),电动车使用 |
| engine_cc | int | - | > 0 | 排量(cc),燃油/混动车辆通用 |
| license_plate | string | - | 最长 20 字符 | 车牌号 |
| is_default | bool | - | - | 是否设为默认车辆 |
成功响应 201 Created
返回创建的车辆对象(格式同「4.1」的列表项)。
GET /api/v1/vehicles/{id}
🔒 需要认证
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
| id | UUID | 车辆 ID |
成功响应 200 OK
返回车辆对象(格式同「4.1」的列表项)。
PATCH /api/v1/vehicles/{id}
🔒 需要认证
请求体(所有字段均可选,格式同「4.2」,另加)
| 字段 | 类型 | 说明 |
|---|---|---|
| is_archived | bool | 是否归档 |
成功响应 200 OK
返回更新后的车辆对象。
DELETE /api/v1/vehicles/{id}
🔒 需要认证
成功响应 204 No Content
权限模型:所有记录接口均支持共享车辆访问。系统先检查用户是否为车辆所有者,若否则检查车辆是否通过群组共享给用户。非车主用户只能编辑/删除自己创建的记录,车主可操作所有记录。
GET /api/v1/vehicles/{id}/records
🔒 需要认证
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
| id | UUID | 车辆 ID |
查询参数
| 参数 | 类型 | 默认值 | 范围 | 说明 |
|---|---|---|---|---|
| page | int | 1 | ≥ 1 | 页码 |
| page_size | int | 20 | 1-100 | 每页条数 |
成功响应 200 OK
{
"code": 0,
"message": "success",
"data": [
{
"id": "770e8400-e29b-41d4-a716-446655440002",
"vehicle_id": "660e8400-e29b-41d4-a716-446655440001",
"fuel_amount": 45.5,
"fuel_unit": "L",
"unit_price": 7.89,
"total_cost": 358.99,
"currency_code": "CNY",
"odometer": 15230.5,
"distance_unit": "km",
"is_full_tank": true,
"fuel_grade": "95",
"station_name": "中石化望京站",
"station_lat": 39.9876543,
"station_lng": 116.4712345,
"note": "",
"receipt_url": "",
"trip_distance": 520.3,
"fuel_efficiency": 8.75,
"refuel_date": "2026-03-25T14:30:00Z",
"created_at": "2026-03-25T14:35:00Z",
"updated_at": "2026-03-25T14:35:00Z"
}
],
"meta": {
"page": 1,
"page_size": 20,
"total": 42,
"total_pages": 3
}
}POST /api/v1/vehicles/{id}/records
🔒 需要认证
请求体
| 字段 | 类型 | 必填 | 校验 | 说明 |
|---|---|---|---|---|
| fuel_amount | float | ✅ | > 0 | 加油量/充电量 |
| fuel_unit | string | - | L / gal / kWh |
燃油/能量单位(默认 L,电动车用 kWh) |
| unit_price | float | - | ≥ 0 | 单价 |
| total_cost | float | ✅ | > 0 | 总费用 |
| currency_code | string | ✅ | 3 字符 | 货币代码(如 CNY) |
| odometer | float | ✅ | > 0 | 里程表读数 |
| distance_unit | string | - | km / mi |
距离单位(默认 km) |
| is_full_tank | bool | - | - | 是否加满 |
| fuel_grade | string | - | 最长 20 字符 | 燃油标号(如 92/95/98) |
| station_name | string | - | 最长 200 字符 | 加油站名称 |
| station_lat | float | - | - | 加油站纬度 |
| station_lng | float | - | - | 加油站经度 |
| note | string | - | 最长 1000 字符 | 备注 |
| refuel_date | string | ✅ | ISO 8601 | 加油日期 |
成功响应 201 Created
返回创建的加油记录对象(格式同「5.1」的列表项)。
GET /api/v1/vehicles/{id}/records/{rid}
🔒 需要认证
成功响应 200 OK
返回加油记录对象(格式同「5.1」的列表项)。
PATCH /api/v1/vehicles/{id}/records/{rid}
🔒 需要认证
请求体:所有字段均可选,格式同「5.2」。
成功响应 200 OK
返回更新后的加油记录对象。
DELETE /api/v1/vehicles/{id}/records/{rid}
🔒 需要认证
成功响应 204 No Content
GET /api/v1/vehicles/{id}/stations
🔒 需要认证
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
| id | UUID | 车辆 ID |
说明
返回当前用户在该车辆上使用过的去重加油站/充电站名称列表(按使用频次降序排列,最多 20 条)。前端用于 AutoComplete 下拉建议。
成功响应 200 OK
{
"code": 0,
"message": "success",
"data": [
"中石化望京站",
"中石油朝阳站",
"壳牌北辰西路站"
]
}权限模型:车辆级统计接口(6.1/6.3/6.4)支持共享车辆访问,群组成员可查看共享给自己的车辆统计数据。全局总览(6.2)仅统计用户自有车辆。
GET /api/v1/vehicles/{id}/stats
🔒 需要认证
成功响应 200 OK
{
"code": 0,
"message": "success",
"data": {
"vehicle_id": "660e8400-e29b-41d4-a716-446655440001",
"vehicle_name": "家用车",
"total_records": 42,
"total_fuel": 1890.5,
"total_cost": 14920.80,
"total_distance": 21500.0,
"avg_efficiency": 8.79,
"best_efficiency": 6.50,
"worst_efficiency": 12.30,
"avg_cost_per_km": 0.69,
"avg_cost_per_fill": 355.26,
"currency_code": "CNY",
"fuel_efficiency_unit": "L/100km"
}
}GET /api/v1/stats/overview
🔒 需要认证
成功响应 200 OK
{
"code": 0,
"message": "success",
"data": {
"total_vehicles": 2,
"total_records": 85,
"total_fuel": 3780.0,
"total_cost": 29800.50,
"total_distance": 43000.0,
"avg_consumption": 8.79,
"currency_code": "CNY",
"costs_by_currency": { "CNY": 29800.50 },
"total_expense_cost": 5200.00,
"expense_costs_by_currency": { "CNY": 5200.00 },
"vehicles": [
{
"vehicle_id": "...",
"vehicle_name": "家用车",
"total_records": 42,
"total_fuel": 1890.5,
"total_cost": 14920.80,
"total_distance": 21500.0,
"avg_efficiency": 8.79,
"best_efficiency": 6.50,
"worst_efficiency": 12.30,
"avg_cost_per_km": 0.69,
"avg_cost_per_fill": 355.26,
"currency_code": "CNY",
"fuel_efficiency_unit": "L/100km"
}
]
}
}GET /api/v1/vehicles/{id}/efficiency-trend
🔒 需要认证
查询参数
| 参数 | 类型 | 默认值 | 范围 | 说明 |
|---|---|---|---|---|
| limit | int | 30 | 1-100 | 返回最近 N 条趋势数据 |
成功响应 200 OK
{
"code": 0,
"message": "success",
"data": {
"vehicle_id": "660e8400-e29b-41d4-a716-446655440001",
"vehicle_name": "家用车",
"efficiency_unit": "L/100km",
"items": [
{
"date": "2026-03-25",
"fuel_efficiency": 8.5,
"trip_distance": 520.3
},
{
"date": "2026-03-18",
"fuel_efficiency": 9.2,
"trip_distance": 480.0
}
]
}
}GET /api/v1/vehicles/{id}/period-stats
🔒 需要认证
查询参数
| 参数 | 类型 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|
| period | string | month |
month / year |
聚合维度 |
| year | int | 当前年 | 如 2026 |
查询年份(按月模式时指定) |
说明
period=month&year=2026:返回 2026 年各月聚合数据 + 2025 年同期数据(用于同比对比)period=year:返回所有年份的年度聚合数据
成功响应 200 OK
{
"code": 0,
"message": "success",
"data": {
"vehicle_id": "660e8400-e29b-41d4-a716-446655440001",
"vehicle_name": "家用车",
"period": "month",
"year": 2026,
"currency_code": "CNY",
"fuel_efficiency_unit": "L/100km",
"items": [
{
"period": "2026-01",
"total_records": 4,
"total_fuel": 180.5,
"total_cost": 1423.95,
"total_distance": 2100.0,
"avg_efficiency": 8.6
},
{
"period": "2026-02",
"total_records": 3,
"total_fuel": 135.2,
"total_cost": 1067.08,
"total_distance": 1560.0,
"avg_efficiency": 8.67
}
],
"prev_items": [
{
"period": "2025-01",
"total_records": 3,
"total_fuel": 150.0,
"total_cost": 1185.00,
"total_distance": 1800.0,
"avg_efficiency": 8.33
}
]
}
}GET /api/v1/health
无需认证
成功响应 200 OK
{
"code": 0,
"message": "success",
"data": {
"status": "ok"
}
}权限模型:创建提醒时支持共享车辆,用户可为自己拥有或群组内共享给自己的车辆创建保养提醒。
GET /api/v1/reminders
🔒 需要认证
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
| vehicle_id | UUID | 可选,按车辆筛选 |
成功响应 200 OK
返回当前用户的所有保养提醒数组,每项包含 id、vehicle_id、type(固定 maintenance)、category(11 种保养类型)、trigger(mileage/time/both)、mileage_interval、time_interval_days、last_mileage、last_date、next_mileage、next_date、is_enabled、is_overdue(计算字段)。
POST /api/v1/reminders
🔒 需要认证
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| vehicle_id | UUID | ✅ | 关联车辆 |
| category | string | ✅ | oil_change / tire_rotation / brake_pads / air_filter / transmission / coolant / spark_plugs / battery / wiper_blades / timing_belt / other |
| trigger | string | ✅ | mileage / time / both |
| mileage_interval | int | 视 trigger | 里程间隔(km) |
| time_interval_days | int | 视 trigger | 时间间隔(天) |
| last_mileage | float | - | 上次保养里程 |
| last_date | string | - | 上次保养日期 |
成功响应 201 Created
GET /api/v1/reminders/{id}— 获取详情PATCH /api/v1/reminders/{id}— 更新(字段同创建,均可选)DELETE /api/v1/reminders/{id}— 删除
GET /api/v1/notifications
🔒 需要认证
返回最近 50 条通知,每项包含 id、vehicle_id(可选)、type(anomaly_fuel / maintenance_due / invite_used)、title、message、reminder_id(可选)、record_id(可选)、is_read、created_at。
GET /api/v1/notifications/unread-count
🔒 需要认证
成功响应 200 OK
{ "code": 0, "message": "success", "data": { "count": 3 } }PATCH /api/v1/notifications/{id}/read— 标记单条已读POST /api/v1/notifications/read-all— 全部标记已读DELETE /api/v1/notifications/{id}— 删除通知
GET /api/v1/users/me/export
🔒 需要认证
导出当前用户的数据。仅导出用户本人数据,不含密码哈希、Token 等敏感内部字段。
查询参数:
| 参数 | 可选值 | 默认 | 说明 |
|---|---|---|---|
format |
csv / zip / json |
csv |
导出文件格式 |
scope |
basic / full |
basic |
导出范围 |
导出范围:
basic(P0 基础版):用户资料、车辆、加油/充电记录full(P1 完整版):在基础版基础上增加开销记录、保养提醒、通知、邀请码、群组关系、共享车辆
格式说明:
csv:三段式单文件 CSV(UTF-8 BOM),仅在 scope=basic 时可用;scope=full 时自动升级为 zipzip:多文件分类导出 ZIP 容器(profile.csv, vehicles.csv, fuel_records.csv, expense_records.csv, reminders.csv, notifications.csv, invite_codes.csv, groups.csv, manifest.json)json:结构化 JSON,带 meta 元数据,方便二次处理
返回二进制流 Content-Disposition: attachment。
| 方法 | 路径 | 认证 | 说明 |
|---|---|---|---|
| POST | /api/v1/auth/register |
❌ | 用户注册 |
| POST | /api/v1/auth/login |
❌ | 用户登录 |
| POST | /api/v1/auth/refresh |
❌ | 刷新 Token |
| POST | /api/v1/auth/logout |
✅ | 用户登出 |
| GET | /api/v1/auth/registration-mode |
❌ | 查询注册模式 |
| GET | /api/v1/health |
❌ | 健康检查 |
| GET | /api/v1/invites/{code} |
❌ | 验证邀请码 |
| POST | /api/v1/invites |
✅ | 创建邀请码 |
| GET | /api/v1/invites |
✅ | 我的邀请码列表 |
| PATCH | /api/v1/invites/{id} |
✅ | 更新邀请码 |
| DELETE | /api/v1/invites/{id} |
✅ | 删除邀请码 |
| GET | /api/v1/users/me |
✅ | 获取用户资料 |
| PATCH | /api/v1/users/me |
✅ | 更新用户资料 |
| PUT | /api/v1/users/me/password |
✅ | 修改密码 |
| DELETE | /api/v1/users/me |
✅ | 注销账号 |
| GET | /api/v1/users/me/export |
✅ | 数据导出(CSV/ZIP/JSON) |
| GET | /api/v1/vehicles |
✅ | 车辆列表 |
| POST | /api/v1/vehicles |
✅ | 添加车辆 |
| GET | /api/v1/vehicles/{id} |
✅ | 车辆详情 |
| PATCH | /api/v1/vehicles/{id} |
✅ | 编辑车辆 |
| DELETE | /api/v1/vehicles/{id} |
✅ | 删除车辆 |
| GET | /api/v1/vehicles/{id}/records |
✅ | 记录列表(分页) |
| POST | /api/v1/vehicles/{id}/records |
✅ | 添加记录 |
| GET | /api/v1/vehicles/{id}/records/{rid} |
✅ | 记录详情 |
| PATCH | /api/v1/vehicles/{id}/records/{rid} |
✅ | 编辑记录 |
| DELETE | /api/v1/vehicles/{id}/records/{rid} |
✅ | 删除记录 |
| GET | /api/v1/vehicles/{id}/stations |
✅ | 站名建议 |
| GET | /api/v1/vehicles/{id}/stats |
✅ | 车辆统计 |
| GET | /api/v1/vehicles/{id}/efficiency-trend |
✅ | 油耗趋势 |
| GET | /api/v1/vehicles/{id}/period-stats |
✅ | 按时段聚合(月/年 + 同比) |
| GET | /api/v1/stats/overview |
✅ | 全局统计总览 |
| GET | /api/v1/reminders |
✅ | 提醒列表 |
| POST | /api/v1/reminders |
✅ | 创建提醒 |
| GET | /api/v1/reminders/{id} |
✅ | 提醒详情 |
| PATCH | /api/v1/reminders/{id} |
✅ | 更新提醒 |
| DELETE | /api/v1/reminders/{id} |
✅ | 删除提醒 |
| GET | /api/v1/notifications |
✅ | 通知列表 |
| GET | /api/v1/notifications/unread-count |
✅ | 未读数 |
| PATCH | /api/v1/notifications/{id}/read |
✅ | 标记已读 |
| POST | /api/v1/notifications/read-all |
✅ | 全部已读 |
| DELETE | /api/v1/notifications/{id} |
✅ | 删除通知 |
| GET | /api/v1/groups |
✅ | 我的群组列表 |
| POST | /api/v1/groups |
✅ | 创建群组 |
| POST | /api/v1/groups/join |
✅ | 通过邀请码加入群组 |
| GET | /api/v1/groups/{id} |
✅ | 群组详情 |
| PATCH | /api/v1/groups/{id} |
✅ | 更新群组信息 |
| DELETE | /api/v1/groups/{id} |
✅ | 删除群组 |
| POST | /api/v1/groups/{id}/regenerate-invite |
✅ | 重新生成邀请码 |
| POST | /api/v1/groups/{id}/leave |
✅ | 退出群组 |
| GET | /api/v1/groups/{id}/overview |
✅ | 群组数据汇总 |
| PATCH | /api/v1/groups/{id}/members/{uid} |
✅ | 更新成员角色 |
| DELETE | /api/v1/groups/{id}/members/{uid} |
✅ | 移除成员 |
| POST | /api/v1/groups/{id}/shared-vehicles |
✅ | 共享车辆到群组 |
| DELETE | /api/v1/groups/{id}/shared-vehicles/{vid} |
✅ | 取消车辆共享 |
| GET | /api/v1/groups/{id}/shared-vehicles |
✅ | 群组共享车辆列表 |
| GET | /api/v1/groups/{id}/leaderboard |
✅ | 排行榜(metric=efficiency/cost/distance/frequency;油耗排行用 energy=fuel/electric 区分燃油车与电动车) |
| GET | /api/v1/groups/{id}/expense-stats |
✅ | 费用统计看板 |
| GET | /api/v1/groups/{id}/stations |
✅ | 加油站推荐共享 |
| Method | Path | Status | 说明 |
|---|---|---|---|
| GET | /api/v1/vehicles/{id}/expenses |
✅ | 开销列表(分页+筛选:category/start_date/end_date/keyword/min_amount/max_amount) |
| POST | /api/v1/vehicles/{id}/expenses |
✅ | 创建开销记录 |
| GET | /api/v1/vehicles/{id}/expenses/{eid} |
✅ | 开销详情 |
| PATCH | /api/v1/vehicles/{id}/expenses/{eid} |
✅ | 更新开销记录(partial update,指针字段) |
| DELETE | /api/v1/vehicles/{id}/expenses/{eid} |
✅ | 删除开销记录 |
| GET | /api/v1/vehicles/{id}/expense-stats |
✅ | 开销统计(按币种、按分类、月度趋势、近30天) |
| GET | /api/v1/vehicles/{id}/expense-vendors |
✅ | 商家名称建议(去重Top20) |