Matka-API:n testaus sandboxissa: mitä sandbox ei näytä

Integraatio läpäisi kaiken, mitä matka-API:n testaus sandboxissa pystyi sille heittämään. Haku palautti lentoja, hotellien saatavuuskysely palautti huoneita, varauskutsu antoi vahvistusnumeron joka ikinen kerta, ja QA hyväksyi sen torstaina. Seuraavana tiistaina asiakas maksoi hotellista yhden hinnan ja toimittaja vahvisti sen toisella, lentovaraus aikakatkaistiin eikä kukaan tiennyt, oliko paikka varattu, ja asiakaspalvelija käytti iltapäivän kahden saman matkan kuvaavan tietueen täsmäyttämiseen. Mikään tästä ei ollut bugi, jonka testit ohittivat. Ne olivat tilanteita, joita testit eivät mitenkään voineet nähdä. Sandbox on välttämätön, se ei ole läheskään riittävä, ja näiden kahden välissä asuvat matkailuintegraation kalleimmat häiriöt.
Tämä on testisuunnitelma kehittäjälle, joka omistaa integraation: mitä sandbox pystyy todistamaan, mitä se luonteeltaan ei pysty, ja miten ero katetaan ilman, että yrityksen kortilla varataan oikeita paikkoja.
Miksi matka-API:n testaus sandboxissa päästää läpi koodia, jonka tuotanto rikkoo
Sandbox lupaa jotain vastausten muodosta, ei niiden käyttäytymisestä. Skeema vastaa tuotantoa. Käyttäytyminen ei lähes koskaan, eikä se ole kenenkään vika: testiympäristöllä ei ole varaa ajaa elävää varastoa, joten se tarjoaa kiinteän joukon hintoja ja huoneita, jotka eivät koskaan lopu, eivät muuta hintaa eivätkä aikataulua. Se vastaa nopeasti, koska kukaan muu ei käytä sitä. Se kaatuu harvoin kesken kutsun.
Tuotanto tekee kaikkea tätä päivittäin. Varasto jaetaan kaikkien muiden myyjien kanssa; joku ketjussa ylempänä välimuistittaa hintoja, ja ne vanhenevat; kuormitettu toimittajajärjestelmä vastaa hitaasti tai ei ollenkaan. Koodia, joka on nähnyt vain sandboxin, on käytännössä testattu vain toimittajaa vastaan, jolla on täydellinen päivä.
Pidä sandboxia siis yhtenä kolmesta kerroksesta. Se todistaa, että kutsut ovat oikein muodostettuja ja jäsennin ymmärtää skeeman. Tallennetut fixturet todistavat, että koodi kestää vastaukset, joita tuotanto oikeasti lähettää. Pieni, harkittu joukko live-tarkistuksia todistaa kytkennät jonkin muututtua. Jokainen kerros saa kiinni sen, mitä kaksi muuta eivät.
Tilanteet, joita sandbox ei yleensä anna
Kirjaa ne ylös ennen kuin kirjoitat ainuttakaan testiä. Sandbox voi simuloida yhden tai kaksi jollakin taikatestiarvolla; useimpia siinä ei yksinkertaisesti ole.
| Tilanne | Mitä tuotanto tekee | Miten sen kattaa |
|---|---|---|
| Hinta muuttuu haun ja varauksen välillä | Varaus onnistuu eri kokonaishinnalla tai epäonnistuu hinnanmuutosvirheeseen, joka on näytettävä | Fixture-pari: hakuvastaus ja varausvastaus eri summalla; varmista, että matkustajalta kysytään uudelleen eikä häntä veloiteta hiljaa |
| Loppuunmyynti saatavuuden ja varauksen välillä | Tarjottu huone tai hintaluokka on poissa, kun yrität varata sen | Fixture toimittajan oikeasta loppuunmyyntivirheestä; varmista, että matkustaja palaa tuloksiin eikä virhesivulle |
| Aikakatkaisu varauskutsussa | Toimittaja on ehkä luonut varauksen, ehkä ei | Aiheuta aikakatkaisu pyynnön lähettämisen jälkeen; varmista, että varauksen tila kysytään ennen mitään uusintayritystä |
| Kaksoislähetys | Tuplaklikkaus tai asiakkaan uusintayritys luo kaksi varausta | Lähetä sama varaus kahdesti samalla idempotency keyllä; varmista, että varauksia on tasan yksi |
| Aikataulumuutos lipun kirjoittamisen jälkeen | Myymäsi lento lähtee nyt eri aikaan tai eri lentonumerolla | Fixture muuttuneesta reitistä; varmista, että muutos tavoittaa asiakkaan omistajan |
| Osittainen onnistuminen monen osan varauksessa | Lento vahvistuu, hotelli ei | Sekafixture; varmista, että järjestelmä kirjaa täsmälleen sen, mikä vahvistettiin, ja hälyttää ihmisen |
| Throttling kuormassa | Rate limit -vastauksia, sitten hitaita vastauksia | Toista tallennettu throttling-vastaus; varmista backoff ja että haku heikkenee eikä kaadu virheeseen |
Voit olla eri mieltä viimeisestä sarakkeesta oman stackisi osalta. Hyvä niin. Olennaista on, että jokaisella rivillä on omistaja ja assertio, koska jokainen niistä osuu kohdallesi jonain päivänä.
Fixturet oikeista vastauksista, ei keksityistä
Matkailuintegraation hyödyllisin tapa on säilyttää vastaukset, jotka yllättivät. Käsin kirjoitettu mock-data kertoo, mitä luulet toimittajan lähettävän; tallennettu vastaus kertoo, mitä se oikeasti lähetti — mukaan lukien kentät, jotka ovat tyhjiä, vaikka dokumentaatio sanoo, etteivät ne koskaan ole, hinnan valuutassa, jota et pyytänyt, ja virheen, joka saapuu onnistumisen tilakoodilla.
Toimiva rutiini:
- Tallenna rajalla. Lokita toimittajakutsujen raa'at pyyntö- ja vastausrungot muussa kuin tuotantoympäristössä, ja tuotannossa otokselle liikenteestä, jos tietosuojasääntönne sen sallivat.
- Siivoa ennen säilyttämistä. Matkustajien nimet, passinumerot, sähköpostit, puhelinnumerot ja maksuviitteet poistetaan ennen kuin fixture päätyy repositorioon. Korvaa ne selvästi väärennetyillä arvoilla, jottei kukaan sekoita fixturea oikeaan varaukseen.
- Nimeä käyttäytymisen mukaan.
hotel-book-price-increased.jsonkertoo seuraavalle kehittäjälle, miksi se on olemassa;response-17.jsonei kerro. - Pidä rumat ikuisesti. Rikkinäinen vastaus, joka kaatoi haun eräänä sunnuntaina, on arvokkain omistamasi tiedosto. Se kuuluu testiin, joka ajetaan jokaisessa commitissa.
Kirjoita sitten contract-testit näitä fixtureja vasten: jäsentimelle, sisäisiin malleihin mappaukselle ja virheiden luokittelulle. Jos toimittaja nimeää kentän uudelleen ja contract-testi kaatuu, saat tietää sen CI:ssä etkä asiakkaalta. Luokittelua käsitellään tarkemmin artikkelissamme varausmoottorin API:n virheenkäsittelystä.
Rahapolkujen testaus kuluttamatta rahaa
Tässä sandbox auttaa vähiten, koska juuri rahapoluissa testiympäristö eroaa oikeasta. Oikea lipunkirjoitus, oikea korttiveloitus ja toimittajan oikea laskutus ovat asioita, jotka on tärkeintä saada oikein ja joita vähiten voi harjoitella livenä.
Jaa ongelma kahtia. Hinnoittelulaskenta on puhdasta logiikkaa, ja sen voi testata kattavasti offline: ota tallennetut hinnat, sovella katesääntösi, valuuttamuunnos ja pyöristys, ja tarkista summa, jonka matkustaja näkee. Tee se hankalille tapauksille — dollarihinta, joka myydään euroissa, kate, joka on yhdessä tuotteessa prosentti ja toisessa kiinteä summa, lapsen hinta, pyöristys, joka eroaa näytön ja veloituksen välillä. Muutaman sentin väärä summa on silti väärä, ja se on väärä jokaisessa varauksessa.
Toinen puolisko ovat maksun ympärillä olevat tilasiirtymät. Mallinna ne eksplisiittisesti — tarjottu, varattu, maksettu, vahvistettu, kirjoitettu, peruttu, hyvitetty — ja testaa, että jokaisella siirtymällä on täsmälleen yksi syy. Kalleimman bugin löytävä testi varmistaa, ettei maksua voi veloittaa varauksesta, jota toimittaja ei ole vahvistanut, eikä vahvistettua varausta voi olla ilman maksutietuetta.
Tee lopuksi mahdottomaksi, että testiajo pääsee oikeaan lipunkirjoitukseen. Ei epätodennäköiseksi; mahdottomaksi. Käynnistystarkistus, joka kieltäytyy ajamasta testejä, kun tuotantotunnukset on ladattu, maksaa yhden rivin ja estää pahimman aamun, jonka integraatiotiimi voi kokea.
Mitä virhe maksaa
Ohitettu tilanne matkailuintegraatiossa näkyy harvoin virheenä. Se näkyy varauksena, joka näyttää hyvältä. Tuplalippu, jota kukaan ei pyytänyt ja joka jonkun on voidattava ennen määräaikaa. Hotelli, joka vahvistettiin hintaan, jonka toimisto joutuu nyt itse kattamaan. Aikakatkaistu varaus, jota järjestelmä yritti uudelleen, joten toimittaja pitää kahta huonetta ja laskuttaa molemmista. Matkatoimiston kautta myydyssä lentolipussa ero kirjoitetun ja myydyn välillä voi palata myöhemmin ADM:nä, kauan sen jälkeen kun myynnin kate on jo käytetty.
Nämä kulut osuvat yritykseen, joka myi matkan, eivät kehittäjään, joka kirjoitti retry-silmukan. Siinä on koko perustelu testata ne ennen julkaisua sen sijaan, että ne opitaan tukipyyntö kerrallaan.
Mitä savutestata jokaisen toimittajamuutoksen jälkeen
Toimittajat muuttavat asioita: uusi API-versio, uusi endpoint, vaihdetut tunnukset, erilainen sisällön mappaus. Oma koodisi ei ehkä ole muuttunut lainkaan. Aja tämä lista silti siinä ympäristössä, joka keskustelee muuttuneen toimittajan kanssa:
- Yksi haku jokaista tuotetta kohden, jota myyt tältä toimittajalta, reitillä tai kaupungissa, jonka tiedät palauttavan tuloksia.
- Jäsennä jokainen tulos pudottamatta yhtään hiljaa; vertaa lukumäärääsi raakavastauksen sisältöön.
- Hinnoittele yksi tulos alusta loppuun ja vertaa näytettyä summaa omaan laskelmaasi raakahinnasta.
- Tee varaus testiympäristössä, lue sen tila takaisin ja vertaa jokaista tallentamaasi kenttää.
- Peru se ja varmista, että peruutus näkyy sekä omissa tiedoissasi että toimittajan puolella.
- Aja tallennetut rumat fixturet uuden jäsentimen läpi.
- Tarkista, että aikakatkaisut ja rate limitit johtavat yhä sovittuun käyttäytymiseen, koska uusi versio voi vastata niihin eri tavalla. Jos vasteajat muuttuivat, viivettä käsittelevä artikkeli selittää, mikä osa on sinun korjattavissasi.
Tarpeeksi lyhyt ajettavaksi joka kerta — ja juuri siitä on kyse. Savutesti, jota kukaan ei aja, koska se vie päivän, ei ole savutesti.
Sandboxin paikka
Mikään tästä ei tee sandboxista vähemmän hyödyllistä. Se tekee siitä rehellisen: paikka, jossa opit skeeman ja varmistat kutsujen olevan oikein, ennen kuin fixturet ja live-tarkistukset ottavat hoitaakseen sen, mihin se ei yllä. Jos arvioit alustan lento- ja hotelli-API:ita, pääsy alkaa keskustelulla eikä itsepalveluavaimella — tuo tämä testisuunnitelma siihen keskusteluun ja kysy, miten yllä olevan taulukon jokainen rivi katettaisiin. Vastaukset kertovat API:sta enemmän kuin sen dokumentaatio.