Tài liệu

Bắt đầu

Thử lại

Mạng sẽ thử lại, và một lần thử lại không bao giờ được tạo ra tài liệu thứ hai hay tiêu tốn thêm một số hóa đơn. Bạn không phải làm gì cho việc đó: nếu một yêu cầu giống hệt yêu cầu bạn đã gửi trong 10 phút qua lại đến (cùng mẫu, cùng giá trị, cùng tiêu đề, cùng khóa), nó trả về tài liệu mà yêu cầu đầu tiên đã tạo, với HTTP 200 và replayed: true thay vì 201.

Việc so khớp cố ý chính xác: đổi tiêu đề là thành tài liệu mới. Nếu bạn muốn tự quyết định thế nào là cùng một yêu cầu, hãy gửi header Idempotency-Key với bất kỳ chuỗi nào là duy nhất cho nó; khóa được ghi nhớ 24 giờ và lần thử lại mang khóa đó trả về cùng tài liệu bất kể phần thân nói gì. Dù cách nào, lần thử lại đến khi yêu cầu đầu vẫn đang chạy sẽ chờ vài giây rồi trả về idempotency_in_flight.