• 关于 OpenAPI 规范
• 总览
• 端点参数
• 开始交互式会话

交互式 API 文档

介绍极狐GitLab API 的交互式文档工具。

关于 OpenAPI 规范

OpenAPI 规范（旧称为 Swagger）定义了一个 RESTful API 的标准的、与语言无关的接口。 OpenAPI 定义文件是 YAML 格式，由极狐GitLab 浏览器自动呈现为更易读的界面。

有关极狐GitLab API 的一般信息，请参阅 API 文档。

总览

交互式 API 文档工具允许直接在 JiHuLab.com 网站上进行 API 测试。只有少数可用的端点与 OpenAPI 规范一起记录，但当前列表演示了该工具的功能。

端点参数

当您展开端点列表时，您会看到描述、输入参数（如果需要）和示例服务器响应。一些参数包括默认值或允许值列表。

开始交互式会话

个人访问令牌 (PAT) 是一种开始交互式会话的方法。 为此，请在主页中选择 Authorize，然后对话框会提示您输入您的 PAT，该 PAT 对当前 Web 会话有效。

要测试端点，首先在端点定义页面上选择 Try it out。根据需要输入参数，然后选择 Execute。在下面的示例中，我们执行了对 version 端点（不需要参数）的请求。 该工具显示请求的 curl 命令和 URL，然后是返回的服务器响应。您可以通过编辑相关参数来创建新响应，然后再次选择 Execute。