Idempotency Key Nedir?

27 Ekim 2025 Pazartesi

Idempotency Key, özellikle API tasarımlarında aynı isteğin birden fazla kez gönderilmesi durumunda sistemin tekrarlayan işlemleri engellemesi için kullanılan bir mekanizmadır. Ağ hataları, zaman aşımı veya istemcinin isteği yanlışlıkla yeniden göndermesi durumunda sistemin aynı işlemi iki kez gerçekleştirmemesi için devreye girer.

Bu anahtar, genellikle her istekle birlikte benzersiz bir kimlik (örneğin UUID) olarak gönderilir. Sunucu bu anahtarı kontrol eder; eğer aynı anahtarla gelen bir istek daha önce işlenmişse, yeni bir işlem başlatmaz ve önceki sonucu döner. Böylece hem veri bütünlüğü korunur hem de sistem tutarlı çalışır.

Örneğin bir ödeme sisteminde kullanıcı “ödeme yap” butonuna iki kez bastığında, iki ayrı çekim yapılmaması gerekir. Idempotency Key burada güvenlik sübabı görevi görür — ilk isteği işler, ikinci isteği algılar ve onu görmezden gelir.

Sonuç olarak Idempotency Key, sistemlerin güvenilirliğini ve öngörülebilirliğini artıran küçük ama kritik bir detaydır. Özellikle finans, e-ticaret ve API odaklı servislerde hatalı tekrarları önleyerek kullanıcı deneyimini güvenli hale getirir.