身份验证与访问控制

一把密钥代表一个集成

管理员在应用的 API 与集成 页面管理 API 密钥。密钥属于分组，而非某位员工。可以创建多把命名密钥、设置或不设置到期时间、替换密钥或将其撤销。完整密钥只显示一次；之后界面只显示前缀和使用信息。请将密钥保存在服务端密钥管理系统中，绝不能放入浏览器或移动应用。

每次集成请求都要发送：

Authorization: Bearer YOUR_API_KEY

在 Scalar 的 Bearer Token 字段中只粘贴密钥本身。Scalar 会自动添加 Bearer ，不要重复输入前缀。

合作方没有登录或 refresh token 交换流程。TrakarIA 会检查密钥、权限、组织状态和商业访问资格。已撤销或过期的密钥无法继续使用。不同系统应使用不同密钥，以便独立轮换而不影响其他集成。

每项操作都要求一个具体权限，例如 vehicles:read 或 inspections:write。通过 API 密钥权限参考为集成选择最小权限。

启动链接仍然要求用户登录

API 密钥验证的是软件。检查启动链接只标识要打开的检查，工作人员仍须在 TrakarIA 中登录。不要把 API 密钥放进启动 URL。链接有效期较短，可通过 API 续期。

API 地址

向 https://api.trakaria.com 发送请求。GET /v1/capabilities 返回有效功能和限制。创建数据前，可先按照快速开始发送只读请求。