تخطَّ إلى المستندات
API

عدم التكرار

جعل إعادة المحاولة آمنة.

كيف تعمل

أرسِل Idempotency-Key على POST /emails أو POST /emails/batch أو POST /templates/{id}/send. ولا يقرؤها أي مسار آخر. فالاستدعاء الأول يؤدي العمل، والتكرار بالمفتاح نفسه يعيد الرسالة ذاتها. كما يضبط POST /emails الترويسة Idempotency-Replayed: true، بينما تبلّغ الدفعة عن replayed في كل عنصر ويبلّغ إرسال القالب عنها في الجسم ويجيب بـ 200 بدل 202. والمطالبة تؤخذ بوصفها عملية الإدراج في قاعدة البيانات نفسها، فلا يمكن لطلبين متسابقين بالمفتاح نفسه أن يفوزا معًا.

ترويسة
Idempotency-Key: invoice-8812

إعادة استخدام مفتاح مع جسم مختلف هي 422 idempotency_key_reuse لا إعادة تشغيل صامتة. وهي تعني في الغالب أن المفتاح اشتُق من شيء ليس فريدًا بما يكفي، وإعادة إرسال رسالة إلى شخص لم يرسلها أسوأ من الرفض.

وفي الدفعة يُمدَّد المفتاح لكل عنصر، فمفتاح واحد على مئة رسالة لا يطويها في الرسالة الأولى.