Ugrás a dokumentációra
API

Idempotencia

Biztonságos újrapróbálkozás.

Működése

Küldj Idempotency-Key fejlécet a POST /emails, POST /emails/batch vagy POST /templates/{id}/send kérésen. Más útvonal nem olvassa. Az első hívás elvégzi a munkát, az azonos kulccsal megismételt hívás pedig ugyanazt az üzenetet adja vissza. A POST /emails emellett beállítja az Idempotency-Replayed: true fejlécet, míg a batch minden elemen jelzi a replayed értéket, a sablonküldés pedig a törzsben jelzi, és 202 helyett 200-zal válaszol. A kulcs lefoglalása maga az adatbázis-beszúrás, így két, azonos kulccsal versengő kérés nem nyerhet egyszerre.

Fejléc
Idempotency-Key: invoice-8812

Ha egy kulcsot eltérő törzzsel használsz újra, az 422 idempotency_key_reuse, nem csendes visszajátszás. Ez szinte mindig azt jelenti, hogy a kulcs nem elég egyedi forrásból származik, és valakinek olyan üzenetet visszajátszani, amelyet nem ő küldött, rosszabb, mint elutasítani.

Egy batchben a kulcs elemenként kiegészül, így ha száz üzenetre egy kulcsot adsz, azok nem olvadnak össze az elsővel.