租赁车辆检查工作流
你的租赁系统负责预订和商业条款。TrakarIA 接收检查车辆所需的上下文，并保存权威的检查档案、原始凭证和已验证的报告版本。
**试用 API 场景：**打开交互式集成测试器。以下文档仍是公开契约与业务场景的权威说明。
| 参与方 | 职责 | 示例 |
|---|---|---|
| 你的租赁系统 | 预订编号、计划时间和商业决策 | 创建 RES-1042；决定是否收取损伤费用 |
| TrakarIA | 检查流程、原始凭证、人工验证和报告历史 | 记录交车状态，并在还车时对比 |
| 工作人员 | 使用自己的 TrakarIA 身份执行操作 | 登录、拍照、复核结果并验证检查 |
分组 API 密钥标识的是软件，不是检查人员，也不会为其授予访问权。工作人员必须登录并具备相应分组权限。整个 Rental 流程也可以不连接 API，直接在应用中完成。
人工操作流程
Section titled “人工操作流程”- 车辆已存在于某个 TrakarIA 分组中，可以由应用创建，也可以由软件同步。
- 一个 Rental 档案保存一次预订的运营上下文。TrakarIA 不替代预订、支付或车辆可用性系统。
- 获授权人员记录交车时的车辆状态，并验证
departure检查。 - 还车时记录当前状态，并验证与交车基准的对比。不存在单独的官方
return报告类型。 - 使用公开 API 时，TrakarIA 可在检查验证后发送签名 Webhook；后端随后读取
departure或comparison报告。
通过 Webhook 接收结果
Section titled “通过 Webhook 接收结果”在 组织 → 集成 → API 密钥 → 管理 Webhook 中添加 HTTP(S) 目标，订阅 rental.departure.completed、rental.return.completed，需要 PDF 通知时再订阅 rental.report.pdf_ready。使用目标的签名密钥验证事件，再按事件 ID 从 API 获取报告：Webhook 是通知，不是完整报告。参阅 Webhook 与事件恢复。
- 车辆：
PUT /v1/vehicles/by-external/{external_id}按稳定外部 ID 创建或更新车辆。 - Rental 档案与计划：
PUT /v1/rentals/by-external/{external_id}将预订关联到车辆并立即加入计划。请求体只有vehicle_external_id必填，其他业务字段可选。保存 Rentalid和planning.entry_id；变更时使用更新的源版本或PATCH。 - **交车：**使用唯一
Idempotency-Key调用POST /v1/rentals/{rental_id}/inspections，正文为{"type":"departure"}。首次创建返回201和already_started: false；之后用新的幂等键调用，会以200和already_started: true返回同一检查，而不会报错或重复创建。工作人员登录并打开launch_url。 - **交车结果：**验证后，
rental.departure.completed表示交车报告可读取。获取报告 JSON 和就绪后的 PDF。 - 还车：对同一路由发送
{"type":"return"}。验证后，rental.return.completed表示相对于交车状态的对比报告可读取；其类型是comparison，不是return。
若遗漏事件，使用 GET /v1/events，再重新读取当前 Rental 状态或报告索引。
其他支持路径
Section titled “其他支持路径”GET /v1/inspections/{inspection_id}读取检查状态；POST .../launch续期已过期链接。- Rental 附件是私有文档，与官方检查照片分开。上传后会自动以只读上下文出现在人工流程中，无需重复上传。
- Evidence 路由提供干净的照片元数据，可单独或批量下载原始图片。公开契约绝不暴露遮罩、轮廓、标注图层或存储 URL。详见报告与原始凭证。
- 驾驶证提取只提供待复核字段，不会静默修改已确认的驾驶人。