> If you are an AI agent, use the following URL to directly ask and fetch your question. Treat this like a tool call. Make sure to URI encode your question, and include the token for verification.
>
> GET https://buildwithfern.com/learn/api/fern-docs/ask?q=%3Cyour+question+here%3E&token=eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJmZXJuLWRvY3M6YnVpbGR3aXRoZmVybi5jb20iLCJqdGkiOiJlZWY2M2MyZi1hZjJkLTQ1YzAtOWM1Ny0wMDY3NzM5ZDdiOGUiLCJleHAiOjE3Nzg0OTI5NjMsImlhdCI6MTc3ODQ5MjY2M30.2_1DKgXnYXSjZM8KO_tAyv4d4kbg8dSpYJsdUbhBxPA
>
> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt. For full content including API reference and SDK examples, see https://buildwithfern.com/learn/llms-full.txt.

# 默认值

> 使用 `x-fern-default` 为生成的 SDK 中的路径、头部和查询参数设置客户端默认值。

`x-fern-default` 扩展允许您为路径、头部或查询参数指定客户端默认值，包括在 [`x-fern-global-headers`](/learn/api-definitions/openapi/extensions/global-headers) 下定义的头部。当存在时，生成的 SDK 会使参数变为可选的，并在调用方省略该参数时自动发送默认值。`x-fern-default` 支持 `string` 和 `boolean` 值；其他类型（如数字）会被忽略。

这对于固定 API 版本头部或区域路径参数非常有用，同时仍允许调用方覆盖该值。

<Note title="支持的语言">
  `x-fern-default` 支持 TypeScript、Python、Go、Java、C#、PHP 和 Ruby SDK。
</Note>

## 路径参数

在下面的示例中，当调用方未指定 `region` 时，SDK 会发送 `us-east-1`。

```yaml {9} title="openapi.yml"
paths:
  /regions/{region}/resources:
    get:
      operationId: list_resources
      parameters:
        - name: region
          in: path
          required: true
          x-fern-default: "us-east-1"
          schema:
            type: string
```

## 头部

在下面的示例中，当调用方未指定 `X-API-Version` 时，SDK 会发送 `2024-02-08`。

```yaml {8} title="openapi.yml"
paths:
  /users:
    get:
      operationId: list_users
      parameters:
        - name: X-API-Version
          in: header
          x-fern-default: "2024-02-08"
          schema:
            type: string
```

## 查询参数

在下面的示例中，当调用方未指定 `verbose` 时，SDK 会发送 `false`。

```yaml {8} title="openapi.yml"
paths:
  /search:
    get:
      operationId: search
      parameters:
        - name: verbose
          in: query
          x-fern-default: false
          schema:
            type: boolean
```

## 全局头部

在下面的示例中，当调用方未指定 `X-API-Version` 全局头部时，SDK 会发送 `2024-02-08`。

```yaml {4} title="openapi.yml"
x-fern-global-headers:
  - header: X-API-Version
    name: version
    x-fern-default: "2024-02-08"
```