文档

快速入门

重试

网络会重试,而重试绝不能生成第二个文档或浪费第二个发票编号。你无需为此做任何事:如果与你在过去 10 分钟内发送的请求完全相同的请求再次到达(相同模板、相同值、相同标题、相同密钥),它会返回第一次请求生成的文档,状态为 HTTP 200 并带 replayed: true,而不是 201。

匹配是刻意精确的:改变标题就是一个新文档。如果你更愿意自己决定什么算同一个请求,请发送 Idempotency-Key 头,值为对该请求唯一的任意字符串;该键会保留 24 小时,带有它的重试无论请求体内容如何都会返回同一个文档。无论哪种方式,若重试在第一个请求仍在运行时到达,它会等待几秒然后返回 idempotency_in_flight。