Cum împiedici reîncercările unei integrări să creeze dubluri

01

Identifică operațiunea o singură dată

Numărul comenzii, evenimentul și încercarea cererii sunt identități diferite. Definim acțiunea unică și îi păstrăm identitatea între încercări. O cerere nouă nu devine automat o comandă nouă. Modificarea intenționată produce o operațiune distinctă, legată de cea anterioară.

Lăsăm intenția de creare ca unitate stabilă și înregistrăm încercările sub ea. Identitatea supraviețuiește repornirii și relivrării din coadă. Stabilim ce schimbare produce intenție nouă: adresa poate fi actualizare, a doua comandă este altă acțiune. Deciziile apar în contractul operațional pentru ca reluarea să nu înlocuiască accidental modificarea. Includeți și identitatea sistemului sursă, unde numerele se pot repeta între entități. Operatorul trebuie să poată urmări relația dintre comanda inițială, încercările tehnice și eventualele modificări autorizate ulterior, fără să deducă sensul doar din ordinea mesajelor.

02

Păstrează rezultatele accesibile reluării

Unde API-ul oferă chei de idempotentă, respectăm durata, parametrii și regulile repetării. Conectorul își păstrează încercările și rezultatele. În lipsa mecanismului, analizăm căutarea în destinație, serializarea sau reconcilierea. O cheie generată local nu garantează ce destinația nu promite.

Salvăm identitatea și datele relevante înainte de trimitere, apoi referința destinației când apare. Analizăm oprirea dintre pași. Tranzacția locală nu face singură atomic apelul extern. Pot fi necesare coadă de ieșire, căutare în destinație sau reconciliere, după contract. Explicăm garanțiile exact, fără promisiunea generală că operațiunea se execută o singură dată în orice condiții. Verificăm și durata în care destinația recunoaște cheia, deoarece reluarea după expirare poate avea alt comportament. Politica păstrării istoricului trebuie să susțină perioada reală în care firma poate recupera operațiuni întârziate.

03

Separă reluarea sigură de investigație

Unele erori confirmă respingerea; altele lasă rezultatul incert. Datele schimbate pe aceeași operațiune cer atenție. Afișăm stările distinct pentru a evita crearea forțată a dublurii. Recuperarea păstrează contextul și motivul autorizării unei acțiuni noi când investigația o cere.

Clasificăm erorile după ce știm despre rezultat. Validarea documentată permite corectare; conexiunea pierdută după trimitere nu poate fi tratată identic. Limităm reluările și păstrăm starea incertă când rezultatul nu se stabilește. Operatorul vede încercările și căutarea destinației înainte de o nouă creare. Evităm resetarea care șterge dovada. Interfața poate separa reluarea aceleiași cereri de autorizarea unei operațiuni înlocuitoare. Această diferență este importantă în special când răspunsul furnizorului întârzie, iar persoana încearcă să rezolve problema înainte de apariția confirmării inițiale.

04

Controlează autoritatea de reluare

Vizualizarea erorii nu implică drept de reluare a scrierii. Limităm acțiunea și înregistrăm decizia operatorului. Cheile și URL-urile nu conțin credențiale sau dosare personale complete. Jurnalele păstrează identificatori utili fără să devină copii necontrolate ale datelor clienților.

Cheile identifică operațiuni fără nume, conturi sau secrete. Dacă sunt jurnalizate extern, verificăm expunerea relațiilor prin valori previzibile. Reluarea manuală este restrânsă, iar ridicarea blocării are motiv vizibil. Separăm investigația dezvoltatorului de autoritatea comercială. Auditul leagă decizia de datele și acțiunea autorizate. Protejăm și instrumentele folosite pentru căutarea în destinație, deoarece ele pot oferi acces mai larg decât conectorul obișnuit. Persoana care recuperează un caz are nevoie de informația potrivită acelui caz, fără să primească implicit posibilitatea modificării tuturor comenzilor.

05

Testează eroarea de după acceptare

Testul esențial întrerupe conexiunea după acceptarea comenzii și înaintea salvării răspunsului. Testăm evenimente duplicate, încercări simultane și parametri modificați. Numărăm dublurile și rezultatele nerezolvate. Un panou HTTP verde nu ajută când două încercări reușite au creat două comenzi.

Pregătim întreruperi înainte de trimitere, după acceptare și înainte de salvarea confirmării. Adăugăm livrări simultane și aceeași cheie cu date schimbate. Verificăm înregistrările destinației și rezultatele locale după recuperare. Măsurăm separat incertitudinile și dublurile: blocarea tuturor reluărilor evită duplicatele, dar poate pierde munca legitimă. Dovezile arată rezultatul cunoscut al operațiunii intenționate. Includem un lot cu succes parțial și repornirea procesului care îl gestionează, pentru a verifica dacă identitatea fiecărui element rămâne stabilă și elementele acceptate nu sunt create din nou.

• Păstrează identitatea operațiunii între reluări, reporniri și relivrări din coadă, fără generarea unei intenții noi de comandă.
• Testează oprirea după acceptarea destinației și înainte de înregistrarea locală a confirmării de către conector.
• Verifică durata cheii și comportamentul datelor schimbate în destinație, fără presupunerea unor garanții universale de idempotentă.
• Numără separat lucrul legitim nerezolvat și dublurile și păstrează dovezile înainte de autorizarea oricărei reluări manuale.

06

Definește recuperarea după contractul real API

Putem evalua un conector existent sau construi identitatea operațiunii, stocarea rezultatelor și interfața recuperării. Avem nevoie de documentația destinației și erorile întâlnite. Oferta identifică limitele care cer proceduri operaționale, de exemplu imposibilitatea găsirii sigure a unei cereri acceptate.

Putem evalua modelul conectorului și recuperarea după API-ul real. Remedierea poate introduce identități durabile și reconciliere fără înlocuirea platformei. Dacă destinația este insuficientă, propunerea arată controlul manual pentru incertitudini. Tratăm separat loturile și curățarea istorică: prevenirea nu identifică automat dublurile existente. Oferta precizează cum demonstrăm corectitudinea remedierii și cine acceptă operațiunile recuperate. Accesul la mediul de test, documentația limitelor și exemplele incidentelor permit o estimare mai exactă decât simpla cerere de a adăuga încă o încercare automată.