跳转到主要内容
来自 Speakeasy SDK 的自动生成代码片段可直接集成到 Mintlify 的 API 参考文档中。这些 SDK 使用示例将显示在由 Mintlify 驱动的文档站点的交互式操作台中。
带有 Speakeasy 代码片段的 Mintlify API 操作台。

​
前提条件

要将 Mintlify 与 Speakeasy 集成，你需要：

​
设置集成

要将 Speakeasy 与 Mintlify 集成，你需要从注册中心获取该 API 的合并规范的公共 URL，并更新你的 docs.json 配置文件。

​
从注册表获取 API 的合并规范公开 URL

前往你的 Speakeasy 控制台，打开 API Registry 标签页。打开该 API 的 *-with-code-samples 条目。
Speakeasy API Registry 页面截图。API Registry 标签页以红色方框和数字 1 标注，API 的条目以红色方框和数字 2 标注。
如果该条目未标记为 Combined Spec，请确保该 API 已配置自动代码示例 URL。
在该注册表条目的页面上，复制提供的公开 URL。
显示合并规范注册表条目的截图，其中“复制 URL”功能以红色方框突出显示。

​
更新你的 docs.json 配置文件

将合并后的规范 URL 添加到 docs.json 文件中的 Anchors 或 Tabs 部分。 在 docs.json 文件中按如下方式更新 anchor 字段，将合并后的规范 URL 添加到对应锚点：
docs.json
{
  "anchors": [
    {
      "name": "API 参考",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL",
      "url": "api-reference",
      "icon": "square-terminal"
    }
  ]
}
通过如下方式在 docs.json 文件中更新 tab 字段，将合并后的规范 URL 添加到一个标签页中：
docs.json
{
  "tabs": [
    {
      "name": "API 参考",
      "url": "api-reference",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL"
    }
  ]
}
现在，Speakeasy 生成的代码片段已可在你的 API 文档中查看，并可在演示区中交互使用。