> This page is for SDK, version Current (default).
> For other versions, use one of these documentation indexes:
> - Current (default): https://buildwithfern.com/learn/sdks/current/llms.txt
> - Legacy: https://buildwithfern.com/learn/sdks/legacy/llms.txt

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

# 配置全局头部

> 了解如何在 Fern SDK 中配置全局头部。将 API 头部设置为构造函数参数，自动包含在所有请求中。

如果您的 API 在每个请求（或大部分请求）中都需要特定的头部，您可以将它们配置为 **全局头部**。Fern 将生成一个 SDK，在客户端构造函数中接受这些头部一次，并自动将它们包含在所有 API 调用中。

## 生成的 SDK 行为

一旦您配置了全局头部，Fern 会生成一个 SDK，将头部值作为构造函数参数接受：

```python
import os

class Client:

  def __init__(self, *, apiKey: str):
```

SDK 用户只需提供一次值，生成的 SDK 会自动将头部包含在所有请求中。

## 设置全局头部

Fern 会自动识别在每个请求或大部分请求中使用的头部，并将它们标记为全局头部。您可以在 API 定义中手动配置额外的全局头部：

**`openapi.yml`**

```yaml title="openapi.yml"
x-fern-global-headers:
  - header: custom_api_key
    name: api_key
  - header: userpool_id
    optional: true
```

您还可以在全局头部上固定一个[默认值](/learn/zh/api-definitions/openapi/extensions/default-values)，这样当调用者不提供值时，SDK 会自动发送它。

有关完整的配置详细信息，请参阅 [OpenAPI 中的全局头部](/learn/zh/api-definitions/openapi/extensions/global-headers)。