​
添加 AsyncAPI 规范文件

要开始为你的 WebSocket 创建页面，请确保你拥有一份有效的 AsyncAPI 架构文档（JSON 或 YAML 格式），并遵循 AsyncAPI 规范。你的架构必须符合 AsyncAPI 3.0+ 规范。
要验证你的 AsyncAPI 架构是否有效，你可以将其粘贴到 AsyncAPI Studio

​
自动生成 websockets 页面

你可以在 docs.json 的导航中任意选项卡或分组添加一个 asyncapi 字段。该字段可以是文档仓库中 AsyncAPI 架构文档的路径、托管的 AsyncAPI 架构文档的 URL，或指向多个 AsyncAPI 架构文档的链接数组。Mintlify 会为每个 AsyncAPI websocket 渠道自动生成一个页面。 Tabs 示例： 
"navigation": {
  "tabs": [
    {
        "tab": "API Reference",
        "asyncapi": "/path/to/asyncapi.json"
    }
  ]
}
Groups 示例： 
"navigation": {
  "tabs": [
    {
      "tab": "AsyncAPI",
      "groups": [
        {
          "group": "Websockets",
          "asyncapi": {
            "source": "/path/to/asyncapi.json",
            "directory": "api-reference"
          }
        }
      ]
    }
  ]
}
directory 字段是可选项。若未指定，文件将放置在文档仓库的 api-reference 文件夹中。

​
Channel 页面

如果你想更精确地控制频道的排序，或者只想引用某个单独的频道，你可以创建一个在 frontmatter 中包含 asyncapi 字段的 MDX 文件。 
---
title: "Websocket Channel"
asyncapi: "/path/to/asyncapi.json channelName"
---