Bỏ qua tới phần tài liệu
API

Tính lũy đẳng

Giúp việc thử lại an toàn.

Cách hoạt động

Gửi Idempotency-Key trên POST /emails, POST /emails/batch hoặc POST /templates/{id}/send. Không route nào khác đọc header này. Lệnh gọi đầu tiên thực hiện công việc, và lệnh lặp lại với cùng khóa trả về đúng thư đó. POST /emails còn đặt Idempotency-Replayed: true, trong khi lô báo replayed trên từng mục và lệnh gửi bằng mẫu báo nó trong phần thân và trả về 200 thay vì 202. Việc giành quyền xử lý chính là thao tác chèn vào cơ sở dữ liệu, nên hai yêu cầu chạy đua với cùng khóa không thể cùng thắng.

Header
Idempotency-Key: invoice-8812

Dùng lại một khóa với phần thân khác sẽ trả về 422 idempotency_key_reuse thay vì âm thầm phát lại. Điều này gần như luôn có nghĩa là khóa được tạo từ một thứ không đủ duy nhất, và phát lại cho ai đó một thư mà họ không gửi còn tệ hơn là từ chối.

Trong một lô, khóa được mở rộng cho từng mục, nên một khóa cho một trăm thư sẽ không gộp tất cả thành thư đầu tiên.