在 API 研发管理产品中，几乎所有的协作工作都是围绕着 API 文档进行的。
我们在接触了大量的客户后发现，采用 文档驱动 的协作模式会比 先开发、后维护文档 的方式更好，团队协作效率和产品质量都能得到提高。因此我们建议您尝试基于文档来进行工作，使用 文档驱动 方式来降低大量无意义的沟通成本。
产品支持几种创建API文档的方式：
- 手动创建文档：适合所有团队；
- 根据代码注解自动生成文档：适合使用过或正在使用Swagger产品来自动生成文档的团队。
- 根据代码模板快速创建API文档：适合所有团队。
当您创建了 API 文档之后，您可以随时查看 API 的改动情况、根据 API 文档发起 API 测试、编写 API 测试用例、使用 Mock API等。
如下图是在系统中管理的API文档，可以详细的看到API的描述信息、变更历史、测试用例、Mock API等内容。
手动创建API
在项目详情页点击左侧API文档功能，进入API管理页面，点击 添加API，会进入 API 创建页面。
私有云产品比线上SaaS产品支持更多的API协议，比如Websocket、TCP、UDP、SOAP、HSF等。
API 编辑页面中可以填写 API 文档、返回数据、额外说明等信息，您可以通过顶部的标签切换。
填写API文档
在API描述标签页中填写API的请求路径、API名称、标签、负责人等基本信息信息。
- API 状态：可以方便成员查看API当前所处的状态，并且进行状态流转的通知;
- Tag 标签：可以作为API的备注或者是筛选条件;
- 负责人：当API文档内容发生变化时，负责人会自动收到API变更通知。
API 请求参数
设置请求头部（request header）
您可以输入或导入请求头部。
批量导入的数据格式为 key : value ，一行一条 header 信息，如：
Connection: keep-aLIve
Content-Encoding: gzip
Content-Type: appLIcation/json
Date: Mon, 30 Dec 2019 20:49:45 GMT
设置请求体（request body）
请求体提供了五种类型：
- Form-data（表单）
- Json
- XML
- Raw（自定义文本类型数据）
- Binary（字节流、文件参数）。
对于Form-data（表单）、Json、XML等数据类型，可以通过引用事先编辑好的 数据结构 来快速填写内容。
设置 Query 参数
Query 参数指的是地址栏中跟在问号？后面的参数，如以下地址中的 user_name 参数：
/user/login?user_name=jackLIu
批量导入的数据格式为 ?key=value… ，通过&分隔多个参数，如：
api.eoLInker.com/user/login?user_name=jackLIu&user_password=hello
设置 REST 参数
REST 参数指的是地址栏被斜杠/分隔的参数，如以下地址中的使用大括号包裹起来的 user_name、user_password 参数：
/user/login/{user_name}/{user_password}
注意，您只需要在URL中使用{}将REST参数括起来。API文档和测试时，下方表格的参数名不需要使用{}。
API 响应内容
设置响应头部（response header）
您可以输入或导入响应头部。批量导入的数据格式为 key : value ，一行一条 header 信息，如：
Connection: keep-aLIve
Content-Encoding: gzip
Content-Type: appLIcation/json
Date: Mon, 30 Dec 2019 20:49:45 GMT
设置响应内容（response body）
响应内容的编写方式和请求参数的类似，响应内容提供了四种类型：
- Json
- XML
- Raw（自定义文本类型数据）
- Binary（字节流、文件参数）
对于 Json、XML 等数据类型，可以通过引用事先编辑好的 数据结构 来快速填写内容。系统也提供了导入功能方便您快速导入参数信息。
根据代码注解自动生成文档
该功能仅付费版产品提供。
点此查看相关教程。
根据代码模板快速创建API文档
该功能仅付费版产品提供。
点此查看相关教程。
