OpenAPI

手动编写 REST API 文档可能是一个耗时的过程。幸运的是，GitBook 通过允许您导入 OpenAPI 文档来简化此任务，这些文档详细描述了您的 API 的结构和功能。

OpenAPI 规范（OAS）是开发人员用来记录 REST API 的一个框架。它以 JSON 或 YAML 编写，概述了您的所有端点、参数、模式和认证方案。

一旦导入到 GitBook 中，这些文档会被转换为交互式且可测试的 API 模块，直观地展示您的 API 方法——无论规范是作为文件提供还是从 URL 加载。

GitBook 支持 Swagger 2.0 或 OpenAPI 3.0 兼容的文件。

POST /api/v3/pet HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 133

{
  "id": 10,
  "name": "doggie",
  "category": {
    "id": 1,
    "name": "Dogs"
  },
  "photoUrls": [
    "text"
  ],
  "tags": [
    {
      "id": 1,
      "name": "text"
    }
  ],
  "status": "available"
}

{
  "id": 10,
  "name": "doggie",
  "category": {
    "id": 1,
    "name": "Dogs"
  },
  "photoUrls": [
    "text"
  ],
  "tags": [
    {
      "id": 1,
      "name": "text"
    }
  ],
  "status": "available"
}

进行测试（由 Scalar 提供支持）

GitBook 的 OpenAPI 模块还支持“进行测试”功能，允许您的用户使用从编辑器填充的数据和参数来测试您的 API 方法。

由以下提供支持 Scalar，您无需离开文档即可查看您的 API 方法的实际运行效果。上方有一个示例。

常见问题