Belgelere geç
API

İ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.

Başlık
Idempotency-Key: invoice-8812

Bir 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.