选择集成模式

车辆检查始终由获授权人员在 TrakarIA 应用中完成。首先要确定的是：由谁创建业务档案并准备检查。是否连接 API 与是否提供“打开检查”按钮，是两个独立选择。

模式	你的系统负责	工作人员负责	适用场景
仅使用应用	不调用公开 API，也不同步预订	在 TrakarIA 中选择或创建车辆，启动交车/还车并填写信息	未连接租赁系统的团队
使用 API，不提供按钮	同步车辆和档案，使预订立即进入计划，并准备交车和还车检查	在计划中找到已准备的检查并验证	已连接软件，且团队本来就在 TrakarIA 中工作
使用 API 并直接打开	执行相同调用，并提供临时 launch_url 按钮	直接打开正确流程，登录并验证	希望在自身软件中提供连贯体验

只在应用中创建的检查周期，不会因为之后接入 API 而自动变成 /v1/rentals 档案。

关联式流程

1. 后端使用分组 API 密钥发送车辆和 Rental 上下文。Rental 立即出现在计划中。请求体只有车辆外部 ID 必填，其余信息可提前、现场交车时或之后用新版本补充。所有调用必须在服务端执行。
2. 后端使用 Idempotency-Key 调用 POST /v1/rentals/{rental_id}/inspections，类型为 departure 或 return。
3. 响应包含检查 ID 和短期 launch_url。你的应用可以使用普通导航或新标签页打开它。
4. 工作人员没有会话时需要登录。TrakarIA 会检查其个人分组访问权与权限。
5. 人工验证完成后，后端接收签名事件，或通过 GET /v1/events 恢复遗漏事件，然后读取已验证报告。

链接过期后，可通过 POST /v1/inspections/{inspection_id}/launch 续期。它只是导航工具，不是访问令牌；不要写入日志、分析系统或公开页面。TrakarIA 也可以嵌入你的应用；请联系支持团队审核并允许相应域名。未经批准的应用仍会被阻止嵌入。

也可以只完成系统间交接

如果工作人员本来就在 TrakarIA 中工作，则无需提供打开按钮。后端仍需要 API 密钥来同步车辆和档案并准备检查，工作人员再从 TrakarIA 应用中继续。若启动 Checkout 时未明确选择计划条目，TrakarIA 会显示该车辆可用的预订，也允许创建不关联预订的现场 Checkout。关联可带入上下文，但不会成为阻止实际交车的前置条件。

何时使用回调

系统需要及时响应验证结果时，使用 Webhook。验证签名、按事件 ID 去重，再读取当前资源；停机后使用 GET /v1/events 恢复。rental.departure.completed 表示交车 JSON 已就绪，rental.return.completed 表示对比 JSON 已就绪；PDF 可能稍后通过独立事件变为可用。