For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
预约演示登录免费开始
  • 概览
    • 什么是 API 定义?
    • 项目结构
      • 概览
      • 覆盖层(Overlays)
      • 覆盖(Overrides)
      • 身份验证
      • 服务器
      • 同步您的规范
        • 概览
        • API 版本
        • 受众
        • 可用性
        • 基础路径
        • 默认值
        • 枚举描述、名称和可用性
        • API Explorer 控制
        • 全局请求头
        • 忽略元素
        • SDK 变量
        • SDK 方法名称
        • 参数名称
        • 属性名称
        • 幂等性
        • 分页
        • 重试行为
        • Schema 名称
        • 服务器名称和 URL 模板化
        • 模式名称
        • 服务器名称和 URL 模板化
      • OpenAPI generators.yml 参考
Checking status...
SOC2Soc 2 Type II
© 2026 Fern • Birch Solutions, Inc., a Postman company

Documentation

SDKsDocsAsk FernCLI Reference

API Definitions

OpenAPIAsyncAPIOpenRPCgRPC

Resources

BlogSupportPricing

Company

Brand KitPrivacy PolicyTerms of Service
LogoLogo
预约演示登录免费开始
在本页
  • 顶级方法
  • 多级嵌套
OpenAPI扩展

自定义 SDK 方法名称

||以 Markdown 格式查看|
此页面是否有帮助?
在仪表板中编辑
上一个

忽略元素

下一个

SDK 变量

使用 x-fern-sdk-group-name 和 x-fern-sdk-method-name 扩展来控制端点在您的 SDK 和 CLI 中的组织方式。

Fern 会自动解析 operationId

如果没有扩展存在,Fern 使用您的 operation ID 来生成 SDK 方法名称。将 operation ID 格式化为 {tag_name}_{operation_name}(例如:users_get)以自动生成类似 users.get() 的方法。如果 operation ID 不以 tag 开头,Fern 会直接将其用作方法名称。

在下面的示例中,Fern 将为 POST /users 端点生成一个名为 client.users.create() 的方法。

openapi.yaml
1paths:
2 /users:
3 post:
4 x-fern-sdk-group-name: users
5 x-fern-sdk-method-name: create

顶级方法

如果您省略 x-fern-sdk-group-name 扩展,生成的 SDK 方法将位于客户端的根目录,而不是嵌套在资源组下。在下面的示例中,Fern 将生成一个名为 client.send() 的方法:

openapi.yaml
1paths:
2 /send:
3 post:
4 x-fern-sdk-method-name: send

多级嵌套

查看 merge.dev 如何使用嵌套组的示例这里。

如果您添加多个 x-fern-sdk-group-name 扩展,那么生成的 SDK 将嵌套组名称。生成的 SDK 方法保留组名称的顺序。

在下面的示例中,Fern 将生成一个名为 client.users.notifications.send() 的方法:

openapi.yaml
1paths:
2 /users/notifications:
3 post:
4 x-fern-sdk-group-name:
5 - users
6 - notifications
7 x-fern-sdk-method-name: send