Bikin Idempotency Key di REST API Biar Gak Ada Transaksi Ganda
Yo, fellow developers! Buat kita yang sering ngurusin backend buat aplikasi pembayaran atau e-commerce, pasti pernah ngalamin momen horor: user mencet tombol 'Bayar' dua kali karena koneksi internet lagi ngadat, alhasil saldo kepotong dobel dan order masuk dua kali. Panik? Jelas.
Masalah klasik kayak gini sebenarnya bisa diselesaikan dengan elegan pakai konsep Idempotency Key. Di catatan kali ini, kita bakal bahas cara kerjanya dan gimana cara nge-handle-nya di backend kita.
Apa itu Idempotency?
Secara teori arsitektur, operasi yang idempotent adalah operasi yang kalau dipanggil berkali-kali dengan parameter yang sama, bakal menghasilkan efek samping (state) yang sama persis kayak waktu dipanggil pertama kali.
Method GET, PUT, dan DELETE di HTTP secara native sudah bersifat idempotent. Tapi POST? Belum tentu. Setiap kali kita nge-hit endpoint POST /api/v1/checkout, server bakal bikin resource baru. Di sinilah kita butuh bantuan Idempotency Key.
Alur Kerja Idempotency Key
- Client ngirim request dengan nambahin custom header, contohnya
Idempotency-Key: uuid-v4-unik. - Server ngecek ke database atau cache (Redis) apakah key tersebut pernah dipakai sebelumnya.
- Kalau belum ada: Proses transaksi seperti biasa, simpan key-nya beserta response aslinya dengan TTL (Time To Live) tertentu (misal 24 jam).
- Kalau sudah ada: Jangan proses ulang! Langsung balikin response yang disimpan sebelumnya ke client.
Contoh Implementasi Sederhana (Node.js / Express)
Nih, snippet middleware sederhana buat ngecek idempotency pakai Redis:
const redis = require('./redisClient');
async function idempotencyMiddleware(req, res, next) {
const key = req.headers['idempotency-key'];
if (!key) {
return res.status(400).json({ error: 'Idempotency-Key header is required' });
}
const cachedResponse = await redis.get(`idempotency:${key}`);
if (cachedResponse) {
// Request pernah diproses, balikin cache-nya
const parsed = JSON.parse(cachedResponse);
return res.status(parsed.status).json(parsed.body);
}
// Simpan reference ke response object buat di-intercept nanti
res.sendResponse = res.json;
res.json = async function (body) {
await redis.setex(
`idempotency:${key}`,
86400, // TTL 24 jam
JSON.stringify({ status: res.statusCode, body })
);
res.sendResponse(body);
};
next();
}
module.exports = idempotencyMiddleware;
Tips Best Practice di Lapangan
- Gunakan UUID v4: Pastikan client-lah yang men-generate key unik ini sebelum tombol submit ditekan.
- Locking mechanism: Kalau traffic tinggi, gunakan Redis Distributed Lock (
SETNX) untuk mencegah race condition pas dua request identik masuk di milidetik yang sama. - Simpan di Redis: Jangan taruh data idempotency ini langsung di database utama karena bakal bikin beban I/O naik drastis. Redis adalah pilihan terbaik buat nyimpen data transient kayak gini.
Arsitektur API yang bersih bukan cuma soal cepat merespons, tapi juga tangguh menghadapi error network dari sisi client. Selamat mencoba di project masing-masing, ya!