配置幂等性请求头 | Fern Documentation

企业功能

此功能仅适用于企业计划。如需开始使用，请联系 support@buildwithfern.com。

对于您已配置为幂等的端点，Fern 的 SDK 允许用户为安全的请求重试指定幂等性请求头。通常这些请求头包括 Idempotency-Key，但您也可以指定其他请求头。

生成的 SDK 行为

生成的 SDK 仅为标记为幂等的端点公开幂等性请求头作为参数，确保用户准确知道哪些调用是幂等的。

1 const response = await client.transactions.send({
2   amount: 100,
3   currency: "usd",
4 }, {
5   idempotencyKey: "64099353-b48b-4dcd-98b7-74df1cc57933"
6 });

设置幂等性请求头

配置您的 API 使用的幂等性请求头，然后将各个端点标记为幂等：

openapi.yml

1 x-fern-idempotency-headers:
2   - header: IDEMPOTENCY-KEY
3     name: idempotency_key
4 
5 paths:
6   /plants:
7     post:
8       x-fern-idempotent: true

有关完整配置详情，请参见 OpenAPI 中的幂等性。

1	const response = await client.transactions.send({
2	amount: 100,
3	currency: "usd",
4	}, {
5	idempotencyKey: "64099353-b48b-4dcd-98b7-74df1cc57933"
6	});

1	x-fern-idempotency-headers:
2	- header: IDEMPOTENCY-KEY
3	name: idempotency_key
4
5	paths:
6	/plants:
7	post:
8	x-fern-idempotent: true