配置幂等性请求头

对于您已配置为幂等的端点，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 使用的幂等性请求头，然后将各个端点标记为幂等：

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 中的幂等性。