API integracije lako je demonstrirati, a teško održavati u pogonu. Razlika između krhke i pouzdane integracije obično se pokaže kod timeouta, ograničenja broja zahtjeva, djelomičnih grešaka i neočekivanih promjena u strukturi podataka.
Svaki vanjski sustav tretirajte kao nepouzdan
Produkcijska integracija treba pretpostaviti da će druga strana biti spora, nedostupna, nekonzistentna ili privremeno u krivu. To ne znači da proizvod smije pasti. Znači da aplikacija treba jasna stanja, ponovne pokušaje i vidljivost kada se podaci ne mogu prenijeti kako je predviđeno.
- Namjerno postavite timeoute i pravila ponovnih pokušaja.
- Spremajte događaje integracije kako bi se neuspjeli posao mogao sigurno ponoviti.
- Djelomični uspjeh učinite vidljivim administratorima i timovima podrške.
Postavite granicu oko integracije
Vanjski API-ji ne bi se smjeli prelijevati kroz cijeli kod. Poseban integracijski sloj može prevoditi udaljene podatke u interne strukture, provjeravati obavezna polja i izolirati ponašanje specifično za pojedinog dobavljača. Tako proizvod ostaje stabilan i kada dobavljač promijeni detalje.
Kod sustava koji se snažno oslanjaju na webhookove ta granica treba uključivati i provjeru potpisa, ključeve idempotentnosti, bilježenje događaja i alate za ponovno slanje. Ti mali temelji sprječavaju dvostruke radnje i znatno ubrzavaju traženje grešaka.
Vidljivost je dio same funkcionalnosti
Kada integracija padne, tim mora znati što se dogodilo, koji je klijent pogođen, može li se radnja ponoviti i je li udaljeni servis vratio smislenu grešku. Sami logovi rijetko su dovoljni. Dobre integracije uključuju operativne ekrane, upozorenja i korelacijske ID-jeve.
- Pratite ID-jeve zahtjeva i statusne kodove udaljenih odgovora.
- Neuspjele poslove prikažite na način razumljiv administratorima.
- Upozoravajte na ponovljene greške, a ne na izolirani šum.
Osmislite oporavak prije lansiranja
Najbolje vrijeme za osmišljavanje oporavka jest prije prvog produkcijskog incidenta. Ako tim može ponoviti, preigrati, preskočiti ili ručno riješiti neuspjeli integracijski posao, proizvod nastavlja raditi i kada neka ovisnost ima loš dan.
Pouzdana integracija nije ona koja nikad ne pada. To je ona koja pada jasno, sigurno i s mogućnošću oporavka.