İdempotanlık
Yeniden denemeyi güvenli kılma.
Nasıl çalışır
Idempotency-Key başlığını POST /emails, POST /emails/batch ya da POST /templates/{id}/send üzerinde gönderin. Başka hiçbir uç nokta onu okumaz. İlk çağrı işi yapar; aynı anahtarla yapılan bir tekrar aynı iletiyi döndürür. POST /emails ayrıca Idempotency-Replayed: true başlığını ayarlar; toplu gönderim her öğede replayed bildirir, şablon gönderimi ise bunu gövdede bildirir ve 202 yerine 200 yanıtı verir. Hak iddiası veritabanı eklemesinin kendisi üzerinden alınır; bu yüzden aynı anahtarla yarışan iki istek birden kazanamaz.
Idempotency-Key: invoice-8812Bir anahtarı farklı bir gövdeyle yeniden kullanmak, sessiz bir tekrar değil 422 idempotency_key_reuse verir. Bu neredeyse her zaman anahtarın yeterince benzersiz olmayan bir şeyden türetildiği anlamına gelir ve birine göndermediği bir iletiyi tekrar oynatmak, reddetmekten kötüdür.
Toplu gönderimde anahtar öğe başına genişletilir; böylece yüz iletiye verilen tek bir anahtar hepsini ilkine indirgemez.