اوپن فاینانس و API

کلید تکرارناپذیری

Idempotency key

شناسه یکتایی که همراه درخواست فرستاده می‌شود تا اگر درخواست تکرار شد، عملیات مالی دو بار انجام نشود.

کلید تکرارناپذیری (idempotency key) شناسه یکتایی است که برنامه همراه درخواستی مثل پرداخت یا انتقال وجه می‌فرستد. اگر به‌خاطر قطع شبکه یا تأخیر، همان درخواست دوباره فرستاده شود، سامانه با دیدن کلید تکراری می‌فهمد این همان عملیات قبلی است و به‌جای انجام دوباره، نتیجه قبلی را برمی‌گرداند.

در کار مالی این سازوکار حیاتی است، چون تکرار یک پرداخت یعنی برداشت دوباره از حساب مشتری. برنامه‌ها باید پیش از هر عملیاتی که پول جابه‌جا می‌کند کلید بسازند و در تلاش‌های دوباره همان کلید را بفرستند. همین منطق برای پردازش وب‌هوک‌های تکراری هم به کار می‌رود.

قسمت صوتی این واژه در ۱۹ تیر ۱۴۰۶ در «یک دقیقه با ایران اوپن فاینانس» منتشر می‌شود.

واژه‌های مرتبط