组织、分组与 API 访问

一个组织可以把业务划分到多个分组。分组是成员、车辆和获准访问的业务档案的共享工作空间。成员不会各自拥有一份车辆或检查副本；可以执行的操作仍由角色、权限和分组设置决定。

实际示例

工作空间	常见用途	使用者
运营组	总部团队和统一监督	管理员与管理人员
北区网点子组	本地车辆和检查	北区网点员工
南区网点子组	本地车辆和检查	南区网点员工

子组是可选的。小型租赁企业可让所有人使用一个分组；多网点企业可使用层级划分团队和访问范围。上级组或同级组能否查看、修改某个资源，取决于层级与角色规则。加入某个组并不等于可以不受限制地访问全部下级组。

API 密钥代表什么

管理员在 API 与集成 中为某个特定分组创建一把或多把命名密钥。密钥可配置权限和有效期，也可替换或撤销。它代表为该分组工作的软件集成，不是个人登录凭证，也不会自动成为整个组织的主密钥。不要假设上级组的密钥可以访问所有子组。若各网点需要隔离，请按目标分组分别设计密钥和数据流。

公开 API 以已验证分组为边界管理外部 ID 和资源。例如，一个分组中的 RES-1042 与另一个分组中的同名 ID 是不同资源。集成系统应将使用的分组与外部 ID、返回的公开 ID 一并保存。

打开链接不会授予分组权限

API 返回的短期 launch_url 只用于定位检查。员工仍需登录 TrakarIA，并有权访问资源所属分组和相应操作。不要把分组 API 密钥发送到浏览器或写入链接。参阅身份验证与访问控制和集成模式。