Hoppa till innehållet
Blogg

Testa rese-API i sandlåda: det sandlådan inte visar dig

Tekravel Redaktion
Skriven med hjälp av AI

Integrationen klarade allt som det gick att testa rese-API i sandlåda med. Sökningen gav flyg, hotelltillgängligheten gav rum, bokningsanropet returnerade ett bekräftelsenummer varje gång, och QA godkände på en torsdag. Tisdagen därpå betalade en kund för ett hotell till ett pris och leverantören bekräftade det till ett annat, en flygbokning fick timeout och ingen kunde säga om platsen var reserverad, och en supporthandläggare ägnade eftermiddagen åt att stämma av två poster som beskrev samma resa. Inget av det var en bugg som testerna missade. Det var scenarier som testerna aldrig hade något sätt att se. En sandlåda är nödvändig, den är långt ifrån tillräcklig, och glappet mellan de två är där de flesta dyra incidenter i en reseintegration bor.

Det här är en testplan för utvecklaren som äger integrationen: vad en sandlåda kan bevisa, vad den av princip inte kan, och hur skillnaden täcks utan att boka riktiga platser på företagskortet.

Varför du kan testa rese-API i sandlåda och ändå krascha i produktion

En sandlåda lovar något om svarens form, inte om deras beteende. Schemat matchar produktion. Beteendet gör det nästan aldrig, och det är ingens fel: en testmiljö har inte råd att köra levande lager, så den serverar en fast uppsättning priser och rum som aldrig tar slut, aldrig prissätts om och aldrig byter tidtabell. Den svarar snabbt eftersom ingen annan använder den. Den fallerar sällan mitt i ett anrop.

Produktion gör allt det varje dag. Lagret delas med alla andra säljare; priser cachas av någon längre upp i kedjan och blir inaktuella; en leverantörs system under last svarar långsamt eller inte alls. Kod som bara har sett en sandlåda har i praktiken bara testats mot en leverantör som har en perfekt dag.

Se därför sandlådan som ett av tre lager. Den bevisar att anropen är rätt formade och att din parser förstår schemat. Inspelade fixtures bevisar att koden klarar svaren som produktion faktiskt skickar. En liten, medvetet vald uppsättning live-kontroller bevisar kopplingen efter att något ändrats. Varje lager fångar det de andra två inte kan.

Scenarier som en sandlåda sällan ger dig

Skriv ner dem innan du skriver ett enda test. En sandlåda kan simulera ett eller två med något magiskt testvärde; de flesta har den helt enkelt inte.

ScenarioVad produktion görHur du täcker det
Prisändring mellan sökning och bokningBokningen går igenom till ett annat totalpris, eller misslyckas med ett prisändringsfel som du måste visaFixture-par: ett söksvar och ett bokningssvar med olika total; kontrollera att resenären tillfrågas igen och aldrig debiteras i tysthet
Slutsålt mellan tillgänglighet och bokningRummet eller prisklassen som erbjöds finns inte kvar när du försöker reservera denFixture med leverantörens verkliga slutsåltfel; kontrollera att resenären hamnar tillbaka i resultatlistan, inte på en felsida
Timeout på bokningsanropetLeverantören kan ha skapat bokningen, eller inteInjicera en timeout efter att anropet skickats; kontrollera att du frågar efter bokningsstatus innan något görs om
Dubbel inskickningEtt dubbelklick eller en omsändning från klienten skapar två bokningarSkicka samma bokning två gånger med samma idempotency key; kontrollera att exakt en bokning finns
Tidtabellsändring efter biljettutfärdandeFlyget du sålde avgår nu en annan tid eller med ett annat flightnummerFixture med ändrad resplan; kontrollera att ändringen når den som äger kunden
Delvis lyckad bokning med flera delarFlyget bekräftas, hotellet inteBlandad fixture; kontrollera att systemet registrerar exakt vad som bekräftades och larmar en människa
Throttling under lastRate limit-svar, sedan långsamma svarSpela upp ett inspelat throttling-svar; kontrollera backoff och att sökningen försämras snarare än felar

Du kanske inte håller med om sista kolumnen för din egen stack. Det är okej. Det viktiga är att varje rad har en ägare och en assertion, för var och en av dem kommer att hända dig till slut.

Bygg fixtures av riktiga svar, inte påhittade

Den mest användbara vanan i en reseintegration är att spara de svar som överraskade dig. Handskriven mockdata speglar vad du tror att leverantören skickar; ett inspelat svar visar vad den faktiskt skickade — inklusive fälten som är tomma fast dokumentationen säger att de aldrig är det, priset i en valuta du inte bad om och felet som kommer med en lyckad statuskod.

En rutin som fungerar:

  • Spela in vid gränsen. Logga råa anrops- och svarskroppar för leverantörsanrop i en icke-produktionsmiljö, och i produktion för ett urval av trafiken om dina dataskyddsregler tillåter det.
  • Tvätta innan du sparar. Passagerarnamn, passnummer, e-post, telefonnummer och betalningsreferenser tas bort innan en fixture hamnar i repot. Ersätt dem med uppenbart falska värden så att ingen förväxlar en fixture med en riktig bokning.
  • Namnge efter beteende. hotel-book-price-increased.json berättar för nästa utvecklare varför filen finns; response-17.json gör det inte.
  • Behåll de fula för alltid. Det trasiga svaret som sänkte sökningen en söndag är den mest värdefulla fil du äger. Det hör hemma i ett test som körs vid varje commit.

Skriv sedan contract-tester mot de fixtures: för parsern, för mappningen till interna modeller, för felklassificeringen. Om en leverantör byter namn på ett fält och ett contract-test fallerar får du veta det i CI i stället för från en kund. Klassificeringsdelen går vi djupare in på i vår artikel om felhantering i en bokningsmotors API.

Testa pengaflödena utan att spendera pengar

Här hjälper sandlådan minst, eftersom det är just i pengaflödena som en testmiljö skiljer sig från den riktiga. Riktig biljettutfärdning, riktig kortdragning och riktig fakturering från leverantören är det du mest behöver få rätt och minst kan öva på live.

Dela upp problemet. Prisberäkningen är ren logik och kan testas uttömmande offline: ta inspelade priser, tillämpa dina påslagsregler, valutaomräkning och avrundning, och kontrollera totalen resenären ser. Gör det för de besvärliga fallen — ett pris i euro som säljs i kronor, ett påslag som är procent på en produkt och fast belopp på en annan, ett barnpris, en avrundning som skiljer sig mellan visning och debitering. En total som är fel med några kronor är fortfarande fel, och den är fel på varje bokning.

Den andra halvan är tillståndsövergångarna runt betalningen. Modellera dem uttryckligen — offererad, reserverad, betald, bekräftad, utfärdad, avbokad, återbetald — och testa att varje övergång har exakt en orsak. Testet som fångar den dyraste buggen kontrollerar att en betalning inte kan dras för en bokning som leverantören inte bekräftat, och att en bekräftad bokning inte kan finnas utan en betalningspost.

Gör det till sist omöjligt för en testkörning att nå skarp biljettutfärdning. Inte osannolikt; omöjligt. En kontroll vid uppstart som vägrar köra sviten när produktionsuppgifter är laddade kostar en rad och förhindrar den värsta morgon ett integrationsteam kan få.

Vad det kostar om du gör fel

Ett missat scenario i en reseintegration syns sällan som ett fel. Det syns som en bokning som ser bra ut. En dubblettbiljett som ingen bad om och som någon måste voida innan fristen går ut. Ett hotell bekräftat till ett pris som byrån nu får stå för. En bokning som fick timeout och som systemet försökte igen, så att leverantören håller två rum och fakturerar båda. För en flygbiljett som sålts via en resebyrå kan en avvikelse mellan det utfärdade och det sålda komma tillbaka senare som en ADM, långt efter att marginalen på den försäljningen är förbrukad.

De kostnaderna hamnar hos företaget som sålde resan, inte hos utvecklaren som skrev retry-loopen. Det är hela argumentet för att testa dem före lansering i stället för att lära sig dem ett supportärende i taget.

Vad du röktestar efter varje leverantörsändring

Leverantörer ändrar saker: en ny API-version, en ny endpoint, bytta inloggningsuppgifter, en annan innehållsmappning. Din egen kod kanske inte har ändrats alls. Kör listan ändå, i miljön som pratar med den ändrade leverantören:

  1. En sökning per produkt du säljer från leverantören, på en sträcka eller stad du vet ger resultat.
  2. Tolka varje resultat utan att tappa något i tysthet; jämför ditt antal med vad råsvaret innehåller.
  3. Prissätt ett resultat hela vägen och jämför den visade totalen med din egen beräkning från råpriset.
  4. Gör en bokning i testmiljön, läs tillbaka dess status och jämför varje fält du sparar.
  5. Avboka den och bekräfta att avbokningen syns både i dina register och hos leverantören.
  6. Kör dina sparade fula fixtures genom den nya parsern.
  7. Kontrollera att timeouts och rate limits fortfarande leder till det beteende ni bestämt, eftersom en ny version kan besvara dem annorlunda. Om svarstiderna flyttat sig förklarar artikeln om latens vilken del som är din att åtgärda.

Kort nog att köra varje gång, vilket är poängen. Ett röktest som ingen kör för att det tar en dag är inget röktest.

Där sandlådan hör hemma

Inget av detta gör sandlådan mindre användbar. Det gör den ärlig: platsen där du lär dig schemat och bekräftar att anropen stämmer, innan fixtures och live-kontroller tar över det den inte når. Om du utvärderar plattformens flyg- och hotell-API:er börjar åtkomsten med ett samtal, inte en självbetjäningsnyckel — ta med den här testplanen till det samtalet och fråga hur varje rad i tabellen ovan skulle täckas. Svaren säger mer om ett API än dess dokumentation gör.

Tekravel Redaktion

Desk för resetechnologi

Tekravels desk för resetechnologi skriver för branschen: byråägare, konsolidatorer och utvecklarna som integrerar dem. Varje artikel kontrolleras mot plattformen den beskriver innan den publiceras.