Skip to main content

演示

参见 WebSocket 操作台 了解 AsyncAPI 操作台的示例。

添加 AsyncAPI 规范文件

要为你的 WebSocket 创建页面,你需要提供一个有效的 AsyncAPI 架构文档(JSON 或 YAML 格式),并遵循 AsyncAPI 3.0+ 规范
使用 AsyncAPI Studio 验证你的 AsyncAPI 架构。

自动生成 WebSocket 页面

要为 AsyncAPI 架构中的所有频道自动生成页面,请在任意导航元素中添加 asyncapi 属性。asyncapi 接受文档仓库中 AsyncAPI 架构文件的路径、托管的 AsyncAPI 文档的 URL,或指向 AsyncAPI 架构文档的链接数组。

带选项卡的示例

当你指定多个 AsyncAPI 文件时,每个文件都会生成自己的一组通道页面。

分组示例

directory 字段为可选。若未指定,文件将放置在文档仓库的 api-reference 文件夹中。

频道页面

如果你需要更灵活地控制频道的排序,或只想引用特定频道,请创建一个在前言区(frontmatter)中包含 asyncapi 属性的 MDX 文件。