Enterprise API

Enterprise API

Enterprise 接口使用 /v1/auth/login 返回的用户 JWT(pb_usr_*)。组织和成员管理需要 Enterprise owner。

企业资料

  • GET /v1/enterprise 返回当前 Enterprise 资料。
  • PATCH /v1/enterprise 更新 namebilling_emailplan,仅 owner 可用。

组织

  • GET /v1/enterprise/orgs 查看当前 Enterprise 下的组织。
  • POST /v1/enterprise/orgs 新建组织,支持可选 idname
  • 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 可用。

角色为 owneradminmember。API 会阻止禁用自己,也会阻止禁用或降级最后一个 active owner。

disabled 用户不能登录;账号被禁用后,已有用户 JWT 也会被拒绝。

邀请

  • POST /v1/enterprise/invitations 基于 emailorganization_idroleexpires_hours 创建邀请。
  • POST /v1/enterprise/invitations/{token}/accept 使用有效邀请创建 active Enterprise 用户。

admin 只能邀请用户加入自己的组织,且不能邀请 owner。

用量

  • GET /v1/enterprise/usage 返回 Enterprise 下组织、电脑、打印机和任务的汇总数量。