# 基本概念

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

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

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

### 项目

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


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


<Background>

![CleanShot 2024-12-20 at 15.40.25@2x.png](https://api.apifox.com/api/v1/projects/5097254/resources/485317/image-preview)
</Background>

了解更多：

- [管理项目](https://docs.apifox.com/project-basic-operations.md)
- [管理项目成员](https://docs.apifox.com/project-member-management.md)


### 团队

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

使用团队可以：

- **隔离数据**：不同团队的数据边界彼此独立。成员不会因为加入一个团队，而自动获得其他团队的资源访问权限。
- **控制访问**：通过团队角色和项目角色，为成员分配不同范围的操作权限。
- **安全协作**：成员可以在独立的团队空间中共享资源并协同编辑 API。


<Background>


![image.png](https://api.apifox.com/api/v1/projects/5097254/resources/684656/image-preview)
</Background>

了解更多：

- [管理团队](https://docs.apifox.com/team-basic-operations.md)
- [管理团队成员](https://docs.apifox.com/team-member-management.md)







### 组织

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

使用组织可以：

- **集中管理**：在统一的管理空间中查看和管理多个团队及其 API 项目。
- **统一权限**：统一分配组织角色和管理权限，并将成员分配到不同团队。
- **确保合规**：在不同团队之间建立明确的数据边界和隐私策略。

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

<Background>

![CleanShot 2025-02-19 at 11.43.36@2x.png](https://api.apifox.com/api/v1/projects/5097254/resources/496400/image-preview)
</Background>





简而言之：

- **项目** 是实际进行 API 设计、开发和测试的工作空间。
- **团队** 为特定部门或业务线提供独立、安全的协作环境。
- **组织** 用于在企业范围内集中管理和监督多个团队。



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

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

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

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

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

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

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

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

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

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




