重试行为 (OpenAPI) | Fern Documentation

x-fern-retries 扩展仅在 Python SDK 中受支持。

x-fern-retries 扩展在您的 OpenAPI 规范中为每个端点配置重试行为，覆盖 SDK 用户配置的任何重试设置。使用它可以为非幂等操作（如支付处理或订单创建）禁用重试。

要为特定端点禁用重试，请设置 disabled: true。

openapi.yml

1 paths:
2   /plants/{plantId}:
3     get:
4       x-fern-retries:
5         disabled: true
6       operationId: get_plant
7       parameters:
8         - name: plantId
9           in: path
10           required: true
11           schema:
12             type: string
13   /plants:
14     post:
15       x-fern-retries:
16         disabled: true
17       operationId: create_plant
18       requestBody:
19         required: true
20         content:
21           application/json:
22             schema:
23               type: object
24               properties:
25                 name:
26                   type: string
27                 species:
28                   type: string
29       responses:
30         '201':
31           description: Plant created successfully

当在端点级别禁用重试时，生成的 SDK 不会重试对该端点的失败请求，无论 SDK 用户的自定义配置如何。

1	paths:
2	/plants/{plantId}:
3	get:
4	x-fern-retries:
5	disabled: true
6	operationId: get_plant
7	parameters:
8	- name: plantId
9	in: path
10	required: true
11	schema:
12	type: string
13	/plants:
14	post:
15	x-fern-retries:
16	disabled: true
17	operationId: create_plant
18	requestBody:
19	required: true
20	content:
21	application/json:
22	schema:
23	type: object
24	properties:
25	name:
26	type: string
27	species:
28	type: string
29	responses:
30	'201':
31	description: Plant created successfully