Foglalási motor API hibakezelése: három hiba, ami pénzbe kerül

Az ügyfélszolgálati jegy egy csütörtök esti órán érkezik. Egy vásárló fizetett, az oldal pörgött, majd általános hibát mutatott. A kártyát megterhelték. A naplóidban egy POST látszik a szállító felé, amely sosem kapott választ. Tartott a légitársaság helyet? Senki sem tudja megmondani, és a vásárló vár. A jó foglalási motor API hibakezelése nagyrészt arról szól, hogy soha ne kerülj ebbe a helyzetbe, vagy legalább pontosan tudd, mit tegyél, ha mégis.
A legtöbb integrációs útmutató a hibákat állapotkódok katalógusaként kezeli. Foglalásnál a kódok a könnyű rész. Pénzbe az a néhány helyzet kerül, amikor a kérés úgy tűnik, elbukott, de a világ mégis megváltozott, vagy úgy tűnik, sikerült, a világ viszont nem változott. Három közülük fontosabb a többinél.
Első hiba: az ár elmozdult a keresés és a foglalás között
A keresési találat ajánlat, nem szerződés. A viteldíjakat gyorsítótárazzák, a készlet minden olyan csatornán osztozik, amelyen a szállító értékesít, és a 14:02-kor mutatott összeg néhány perccel később már elavult lehet. A szállító a foglalás létrehozásakor szól, olykor tiszta „a viteldíj megváltozott” válasszal, olykor úgy, hogy egy egyébként sikeres válaszban csendben más végösszeget ad vissza.
A második fajta a veszélyes. Ha a kódod beolvassa a visszaigazolást, elmenti a foglalást, és azt az összeget terheli, amit a vásárló látott, a különbség a árrésedből megy, vagy később egy ADM-ből. A szabály tehát egyszerű: hasonlítsd össze a szállító által visszaigazolt végösszeget azzal, amelyet a vásárló elfogadott, minden alkalommal, kódból, mielőtt a fizetést beszedéd.
Hogy mit teszel eltérésnél, az a különbség méretétől és attól függ, ki viseli. Pár fillér kerekítés a pénznemek között olyan tűréshatár, amit egyszer beállítasz. Minden ennél nagyobb új árként tér vissza a vásárlóhoz, kifejezett elfogadás gombbal. Soha ne nyeld le automatikusan, és soha ne terheld automatikusan.
Második hiba: lefoglalva, de jegy nélkül
Az, hogy létezik PNR, nem azt jelenti, hogy létezik jegy. Sok folyamat előbb létrehozza a foglalást, és az e-jegyet külön lépésben állítja ki, a kettő között határidővel. Ha a fizetés sikerül, a kiállítás meg nem, egy vásárló pénzét és egy olyan foglalást tartasz, amely a maga órája szerint jár le.
A hiba ritkán hangos. A kiállító hívás hibát vagy időtúllépést ad, a foglalás pedig olyan állapotban marad, amelyet az adatbázisod „fizetett”-nek nevez, miközben a szállító még „tartott”-at mond. Közben a kiállítási határidő ketyeg, és az ügyfélszolgálati sorodtól eltérően a légitársaság nem vár.
Kezeld külön állapotként, ne a siker vagy a kudarc változataként. Egy foglalásnak legalább ezek kellenek: létrehozva, tartva, fizetés beszedve, kiállítás folyamatban, kiállítva, sikertelen és visszatéríthető. A „fizetés beszedve, kiállítás folyamatban” az az állapot, amely időzítőt kér: ha egy foglalás túl sokáig áll ott, egy feladatnak újra kell olvasnia a foglalást a szállítótól és döntenie, nem várnia, hogy egy ember észrevegye. A döntés olcsó, ha ismered a szállító határidejét, mert az megmondja, meddig próbálkozhatsz biztonságosan, mielőtt vissza kell térítened.
Harmadik hiba: az időtúllépés ismeretlen kimenettel
Ez a csütörtök esti jegy. A kérésed elment, válasz nem jött, a kapcsolat megszakadt vagy az átjáró feladta. A szállító teljesen, részben vagy egyáltalán nem dolgozhatta fel.
A kísértés az újrapróbálás. Ne ismételj vakon egy foglalás-létrehozó hívást, mert a második kísérlet második foglalást szülhet, a duplikátum pedig valódi költség: két tartott hely, talán két kiállított jegy, visszatérítési vita az egyikről.
A biztonságos sorrend: állj meg, olvass, dönts. Állítsd meg az ügyfél felőli folyamatot őszinte állapottal: „megerősítjük a foglalását”. Olvasd ki a szállító oldalát úgy, hogy megkeresed a foglalást a hívás előtt generált hivatkozással (ezért hozod létre előbb a saját kliens-hivatkozásodat, és küldöd el, ha a szállító fogad ilyet). Csak ezután dönts: ha megvan, a tényleges állapotból folytasd; ha nincs meg a szállító saját feldolgozási ablaka után, biztonságos egyszer újrapróbálni.
Ha a szállító nem enged hivatkozás szerint keresni, keress az utas neve, az útvonal és a dátum szerint szűk időablakban, és az egyezést tekintsd megtaláltnak. Csúnya, de sokkal olcsóbb a duplikátumnál.
Egy döntési táblázat, amivel vitatkozhatsz
| Amit látsz | Amit tudsz | Amit tegyél | Amit ne tegyél |
|---|---|---|---|
| A szállító „a viteldíj megváltozott” választ ad | Semmi nem lett lefoglalva | Mutasd az új végösszeget, kérj elfogadást, futtasd újra a létrehozást | Újrafuttatni a régi árral és reménykedni |
| Siker, de a végösszeg eltér a vásárló által elfogadottól | Van foglalás az új áron | Tartsd vissza a fizetést, kérdezd meg a vásárlót, ha elutasítja, érvényteleníts | Beszedni a régi összeget és lenyelni a különbséget |
| Fizetés beszedve, a kiállító hívás hibát ad | Van PNR, a jegy állapota ismeretlen | Olvasd újra a foglalást, próbáld a kiállítást a határidőn belül, utána téríts vissza | Sikertelennek jelölni a foglalást és elfelejteni a PNR-t |
| Időtúllépés létrehozáskor | A kimenet ismeretlen | Keress a hivatkozásod alapján, aztán folytasd vagy próbáld újra egyszer | Azonnali vak újrapróbálás |
| Időtúllépés lemondáskor | Még mindig felelős lehetsz a szakaszért | Olvasd újra az állapotot, mielőtt bármit mondasz a vásárlónak | „Lemondva”-t mutatni, mert megtörtént a kattintás |
Egy sor, amit vitathatsz: egyes csapatok már az első kiállítási hibánál visszatérítenek, hogy az ügyfél nyugodt maradjon. Kis jegyeknél ez védhető, drágáknál rossz szokás, mert elveszíthetsz egy viteldíjat, amelyet egy perccel később még meg lehetett volna menteni.
Mibe kerül, ha rosszul csinálod
Minden hibának más a számlája. Egy elmulasztott árváltozás minden érintett foglaláson elveszett árrés, gyakran az egyeztetésig észrevétlenül. A lefoglalt, de ki nem állított jegy olyan utas, aki a repülőtéren egy lejárt foglalással és egy kártyaterheléssel jelenik meg, vagyis egyszerre visszaterhelés és hírnévprobléma. A vak újrapróbálás időtúllépés után kettős foglalás, és a légitársaságok vizsgálják a duplikátumokat; ezek mintázata pontosan az, ami ADM-ben végződik.
Ebből semmi nem egzotikus. Ez a szürke vízvezeték-munka, amely a demót elválasztja attól, amit egy hétvégére magára hagyhatsz.
Építsd meg az egyeztető feladatot, mielőtt szükség van rá
Mindhárom hiba ugyanúgy végződik: az adatbázisod és a szállítóé nem ért egyet. Írd meg tehát az összehasonlító feladatot az első incidens előtt, nem utána. Az éjszakai futás a minimum; átmeneti állapotban lévő foglalásokra néhány percenként még jobb. Listázza a tartott, kiállítás alatti vagy ismeretlen állapotban elakadt foglalásokat, megkérdezi a szállítót, mit gondol, és vagy javítja a rekordot, vagy jegyet nyit a bizonyítékokkal.
Őrizz meg minden kérést és választ a foglalási hívásoknál, az időtúllépéseket is, az elküldött hivatkozással együtt. Ha egy vásárló vitatja a terhelést, ez a napló az érved. A késleltetésről szóló vitát is őszintén tartja: lásd mit tehetsz és mit nem az API késleltetésével, hogy az időtúllépések miért az élet részei, nem kiirtandó hibák.
Ha még azon dolgozol, hogyan kösd be magát a szállítói kapcsolatot, a repülőjegy-foglalási API integráció bemutatója a hívások sorrendjét tárgyalja, amelyet ez a cikk feltételez. És ha beszélnél arról, hogyan képeződnek le ezek az állapotok a repülő- és szállás-API-jainkra, a hozzáférés beszélgetéssel indul: nézd meg a travel API oldalt.