Idempotency — Takroriy request'lar sababli duplicate operation'larning oldini olish
Idempotency (idempotentlik) tushunchasi: HTTP metodlari tabiati, Retry tufayli takroriy to'lov/buyurtma xavfi, Idempotency-Key sarlavhasi va UUID bilan Request Interceptor integratsiyasi.
73-dars
Idempotency — Takroriy request'lar sababli duplicate operation'larning oldini olish
Idempotency (Idempotentlik) — bu biror amalni bir necha marta ketma-ket bajarganda ham, tizimning yakuniy holati xuddi birinchi marta bajarilgandek o'zgarmas qolishini anglatadi.
HTTP metodlari nuqtai nazaridan:
GET,PUT,DELETE— Tabiatan idempotent hisoblanadi. Masalan, foydalanuvchini o'chirish (DELETE /users/1) so'rovini ketma-ket 3 marta yuborsangiz ham, foydalanuvchi faqat bitta marta o'chiriladi, keyingi so'rovlar tizimga qo'shimcha zarar yetkazmaydi.POST— Tabiatan idempotent EMAS. Yangi buyurtma yaratish yoki hisobdan to'lov yechish (POST /payments) so'rovi tarmoq xatosi tufayli ikki marta yuborilib qolsa, server ikkita buyurtma ochib qo'yishi yoki mijozdan ikki karra pul yechib yuborishi mumkin.
1. Retry Mechanism bilan yuzaga keladigan xavf
Avvalgi darslarda o'rgangan Retry mexanizmi tarmoq uzilganda juda asqotadi. Biroq quyidagi xavfli stsenariyni ko'rib chiqamiz:
sequenceDiagram
autonumber
actor Client as Frontend (Axios)
participant Server as Backend API & DB
Client->>Server: POST /pay ($100 to'lov)
Server->>Server: Pul yechildi va DB'ga yozildi
Note over Server: Javob qaytishda tarmoq 1s uzildi!
Server--xClient: 503 / Timeout (Javob yetib bormadi)
Note over Client: Axios: "Javob kelmadi, qaytadan yuboraman (Retry)!"
Client->>Server: POST /pay ($100 to'lov takrorlandi)
Server->>Server: Ikkinchi marta $100 yechib olindi! (XATO)
Server-->>Client: 200 OK (Mijozdan jami $200 yechildi)
Bu holatda tarmoq nosozligi sababli mijoz javobni ololmadi, Axios esa yaxshi niyatda so'rovni qayta yubordi. Natijada Duplicate Operation (Takroriy operatsiya) yuz berdi.
2. Yechim: Idempotency Keys (Unikal tranzaksiya kalitlari)
Ushbu muammoning zamonaviy xalqaro standarti — Idempotency Key yondashuvidir (Stripe, PayPal, Adyen va yirik fintech tizimlari aynan shunday ishlaydi).
Mexanizm qanday ishlaydi?
- Frontend mijoz har bir muhim mutatsiya so'rovi (
POST,PUT,PATCH) oldidan o'zida maxsus unikal kalit generatsiya qiladi (odatdaUUID v4). - Ushbu kalit HTTP so'rov sarlavhasiga biriktirilib yuboriladi:
Idempotency-Key: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d - Backend server ushbu kalitni keshda yoki bazada saqlab qo'yadi. Agar tarmoq uzilib, xuddi shu so'rov (aynan shu kalit bilan) yana qayta kelib tushsa:
- Server amalni qaytadan bajarmaydi (pul yechmaydi).
- Aksincha, birinchi urinishda hosil qilingan va saqlab qo'yilgan tayyor javobni qaytaradi.
3. Amaliyot: TypeScript va Axios yordamida Idempotency Key qo'shish
Har bir servisda qo'lda UUID generatsiya qilib o'tirmaslik uchun, markaziy Request Interceptor orqali barcha mutatsiya so'rovlariga avtomatik kalit biriktiramiz:
A. UUID kutubxonasini o'rnatish:
npm install uuid
npm install --save-dev @types/uuid
B. src/api/client.ts faylida interceptor'ni sozlash:
// src/api/client.ts
import axios, { InternalAxiosRequestConfig } from 'axios';
import { v4 as uuidv4 } from 'uuid';
export const apiClient = axios.create({
baseURL: 'https://api.mysite.com/v1',
timeout: 10000,
});
// Mutatsiya metodlari ro'yxati
const MUTATION_METHODS = ['post', 'put', 'patch'];
apiClient.interceptors.request.use(
(config: InternalAxiosRequestConfig) => {
const method = config.method?.toLowerCase() || '';
// Agar so'rov POST, PUT yoki PATCH bo'lsa
if (MUTATION_METHODS.includes(method)) {
// Agar servisda qo'lda maxsus kalit berilmagan bo'lsa, avtomatik yangi UUID generatsiya qilamiz
if (!config.headers['Idempotency-Key']) {
config.headers['Idempotency-Key'] = uuidv4();
}
}
return config;
},
(error) => Promise.reject(error)
);
4. Retry Mechanism va Idempotency uyg'unligi
Endi axios-retry va Idempotency kalitlari birgalikda ishlaganda quyidagi xavfsiz zanjir vujudga keladi:
- Dastlabki so'rov ketdi:
Idempotency-Key: "a1b2-c3d4..."sarlavhasi bilan birga serverga yetib bordi. - Server operatsiyani bajardi: Bazaga yozdi va kalitni saqlab qo'ydi. Biroq tarmoq uzilib, javob yetib bormadi.
- Axios Retry ishga tushdi: Xuddi o'sha config, ya'ni xuddi o'sha
"a1b2-c3d4..."kaliti bilan so'rovni qaytadan yubordi. - Server kalitni tanidi: Server bu kalit bo'yicha to'lov allaqachon yechilganini ko'rib, yangi to'lov yechmadi. Shunchaki oldingi muvaffaqiyatli javobni qaytarib berdi.
5. HTTP Metodlari va Idempotentlik Qoidalari
| HTTP Method | Tabiatan Idempotentmi? | Retry xavfi | Idempotency-Key Zarurati |
|---|---|---|---|
GET |
Ha | Xavf yo'q (Faqat o'qish) | Kerak emas |
HEAD / OPTIONS |
Ha | Xavf yo'q | Kerak emas |
PUT |
Ha | Kam xavf (To'liq almashtirish) | Ixtiyoriy |
DELETE |
Ha | Kam xavf (Yo'q narsani qayta o'chirish) | Ixtiyoriy |
POST |
Yo'q | Juda yuqori (Dublikat resurslar) | Qat'iy tavsiya etiladi |
PATCH |
Shartli | O'rta xavf (Qisman inkrement/yangilash) | Tavsiya etiladi |
Xulosa
Idempotency — moliyaviy va tranzaksiyaviy ilovalar arxitekturasining asosi hisoblanadi. Idempotency-Key sarlavhasidan foydalanish orqali tarmoq uzilishlarida avtomatik qayta urinishlarni (Retry) qo'rqmasdan qo'llash va tizimda takroriy to'lov yoki buyurtmalar paydo bo'lishining oldini olish mumkin.