基本概念

Apifox 提供了完善的管理能力，帮助你高效管理 API 开发流程和团队协作。Apifox 将工作空间划分为项目、团队和组织三个层级，便于按不同的管理范围精确组织资源和权限。

项目、团队和组织的区别

在 Apifox 中，项目、团队和组织分别对应不同的管理边界。

项目

项目是设计、测试和管理 API 及其文档的核心工作空间。你可以在项目中创建、编辑和测试 API，设计和管理 API 文档，并与其他成员协作完成任务。

通过创建多个项目，你可以根据需求对 API 和文档进行分类，进一步提升工作效率和可维护性。每个项目都有独立的设置和权限控制，确保项目安全和数据隐私。

了解更多：

管理项目

管理项目成员

团队

在 Apifox 中，团队是管理项目和成员的基本协作单元。团队可以隶属于某个组织，也可以作为独立的工作空间使用。

使用团队可以：

隔离数据：不同团队的数据边界彼此独立。成员不会因为加入一个团队，而自动获得其他团队的资源访问权限。

控制访问：通过团队角色和项目角色，为成员分配不同范围的操作权限。

安全协作：成员可以在独立的团队空间中共享资源并协同编辑 API。

了解更多：

管理团队

管理团队成员

组织

组织是可选的最高级管理空间，适合需要集中管理多个团队的企业。规模较小的协作团队可以直接使用独立团队；当公司需要跨团队统一管理时，可以再创建组织。

使用组织可以：

集中管理：在统一的管理空间中查看和管理多个团队及其 API 项目。

统一权限：统一分配组织角色和管理权限，并将成员分配到不同团队。

确保合规：在不同团队之间建立明确的数据边界和隐私策略。

组织级管理权限不等同于项目访问权限。成员最终可以访问哪些团队和项目，仍取决于其团队角色和项目角色。

简而言之：

项目是实际进行 API 设计、开发和测试的工作空间。

团队为特定部门或业务线提供独立、安全的协作环境。

组织用于在企业范围内集中管理和监督多个团队。

组织 vs. 团队 —— 该怎么选？

在用 Apifox 的时候，很多人会纠结：到底是直接用组织来管，还是主要依靠团队？其实核心就看两个点——人数多少、业务范围有多大。

如果团队不大，业务也比较集中

比如你们就十来个人，做的也是同一个产品线，这种情况只用团队就够了。团队里可以管理项目、API 和成员，简单高效，不需要再加组织层。

如果规模很大，业务又分散

如果你们公司人多，业务线也五花八门，那最好先建一个组织，再在组织里按业务划分多个团队。每个团队只管自己的项目和成员，互不干扰，边界更清楚。

应该从哪里邀请成员？（项目、团队或组织）

Apifox 支持从项目、团队和组织三个层级邀请成员。不同入口对应不同的成员管理范围和初始角色配置方式；成员最终可以访问哪些内容，取决于其团队角色和各项目的项目角色。

请根据实际协作场景选择邀请入口：

对比项	📁 项目级邀请	👥 团队级邀请	🏢 组织级邀请
邀请入口	进入目标项目，在 “项目设置 → 成员” 中发起邀请	进入 “主窗口 → 成员/权限”，点击 “邀请”	进入组织管理后台，在成员页面发起邀请
适用目的	邀请协作者参与指定项目，并仅配置该项目的访问权限。	将成员加入某一团队，同时配置团队角色和团队内的项目权限。	将人员纳入组织统一管理，集中维护组织结构和付费事项，并按需分配到相应团队。
典型场景	跨部门协作或外包：对方只需要访问一个指定项目。	创建新业务线或部门：对方需要参与同一团队下的多个项目。	新员工入职或跨团队调配：由 HR 或 IT 管理员集中维护组织成员，再按需要将其分配到不同业务团队。
邀请后	受邀者加入当前项目，并同时成为所属团队的成员；团队内其他项目的权限为 “禁止访问”。	受邀者加入当前团队；可设置其团队角色，并通过 “全部项目” 统一设置项目角色，或选择 “自定义” 逐项目配置。	受邀者成为组织成员；邀请时可按需将其加入指定团队，并设置团队角色。

项目、团队和组织的区别#

项目#

团队#

组织#

组织 vs. 团队 —— 该怎么选？#

应该从哪里邀请成员？（项目、团队或组织）#

项目、团队和组织的区别

项目

团队

组织

组织 vs. 团队 —— 该怎么选？

应该从哪里邀请成员？（项目、团队或组织）