> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt.

## HTTP 代码片段现在默认启用

HTTP 代码片段现在默认为所有文档站点启用，让开发者更容易直接在您的 API 参考中查看 cURL、Python、Ruby 和其他 HTTP 客户端示例。以前，此功能需要内部配置才能激活。

您现在可以直接在 `docs.yml` 文件中控制 HTTP 代码片段：

**`docs.yml`**

```yaml title="docs.yml"
# 关闭 HTTP 代码片段
settings:
  http-snippets: false

# 或仅指定特定语言
settings:
  http-snippets:
    - python
    - ruby
```

阅读文档

## 引入可运行端点

通过我们新的交互式组件直接从您的文档测试 API 端点。可运行端点允许您的用户在不离开文档的情况下向您的 API 发送真实的 HTTP 请求，让开发者更容易探索和理解您的 API。

![可运行端点组件](/learn/_fern-img/b7ea0c6f59e4b95acf5c4f954374dfcc00124508548d0070a9abf5bfbc53f005.webp)

将该组件嵌入到您的 MDX 文档中的任何地方，创建一个交互式请求构建器，包含标头、路径参数、查询参数和请求体的表单输入。用户可以执行请求并查看实时响应，包含状态码和语法高亮。

主要功能包括：

* **交互式表单构建器**，根据您的端点定义自动生成输入
* **多示例支持**，当您有多个预配置场景时提供下拉选择器
* **环境选择器**，用于针对生产、测试或开发环境进行测试
* **表单持久化**，在本地存储中保存用户输入，跨会话使用
* **直接导航**，通过"在 API 参考中打开"按钮跳转到完整的 API 参考

阅读文档