Enterprise API
Enterprise API
Enterprise 接口使用 /v1/auth/login 返回的用户 JWT(pb_usr_*)。组织和成员管理需要 Enterprise owner。
企业资料
GET /v1/enterprise返回当前 Enterprise 资料。PATCH /v1/enterprise更新name、billing_email或plan,仅 owner 可用。
组织
GET /v1/enterprise/orgs查看当前 Enterprise 下的组织。POST /v1/enterprise/orgs新建组织,支持可选id和name。DELETE /v1/enterprise/orgs/{id}删除组织;当前组织或仍有关联用户的组织不能删除。
成员
GET /v1/enterprise/members查看 Enterprise 用户,包括 disabled 成员。PATCH /v1/enterprise/members/{id}更新enterprise_role和/或organization_id,仅 owner 可用。DELETE /v1/enterprise/members/{id}禁用用户账号,非硬删除,仅 owner 可用。
角色为 owner、admin 或 member。API 会阻止禁用自己,也会阻止禁用或降级最后一个 active owner。
disabled 用户不能登录;账号被禁用后,已有用户 JWT 也会被拒绝。
邀请
POST /v1/enterprise/invitations基于email、organization_id、role和expires_hours创建邀请。POST /v1/enterprise/invitations/{token}/accept使用有效邀请创建 active Enterprise 用户。
admin 只能邀请用户加入自己的组织,且不能邀请 owner。
用量
GET /v1/enterprise/usage返回 Enterprise 下组织、电脑、打印机和任务的汇总数量。