پرش به مستندات
API

ایدمپوتنسی

امن‌کردن یک تلاش دوباره.

چگونه کار می‌کند

Idempotency-Key را روی POST /emails، POST /emails/batch یا POST /templates/{id}/send بفرستید. هیچ مسیر دیگری آن را نمی‌خواند. فراخوانی نخست کار را انجام می‌دهد، و تکرار با همان کلید همان پیام را برمی‌گرداند. POST /emails علاوه بر این Idempotency-Replayed: true را هم می‌گذارد، در حالی که دسته replayed را روی هر مورد گزارش می‌کند و ارسال قالب آن را روی بدنه گزارش می‌دهد و به‌جای 202 با 200 پاسخ می‌دهد. ادعا به‌صورت خودِ درج در پایگاه داده گرفته می‌شود، پس دو درخواست که با یک کلید مسابقه می‌دهند نمی‌توانند هر دو برنده شوند.

هدر
Idempotency-Key: invoice-8812

استفادهٔ دوباره از یک کلید با بدنه‌ای متفاوت یک 422 idempotency_key_reuse است، نه یک بازپخش خاموش. تقریباً همیشه یعنی کلید از چیزی مشتق شده که به‌اندازهٔ کافی یکتا نبوده، و بازپخش‌کردن پیامی برای کسی که آن را نفرستاده بدتر از رد‌کردن است.

در یک دسته، کلید به‌ازای هر مورد گسترش می‌یابد، پس یک کلید روی صد پیام آن‌ها را در اولی فرو نمی‌ریزد.