Hoppa till innehållet
Blogg

API för flygpriser: varför siffran du ser ännu inte är ett pris att sälja

Tekravel Redaktion
Skriven med hjälp av AI

Demon fungerar. En utvecklare kopplar in ett API för flygpriser i en kalender över de billigaste dagarna att flyga, rutnätet fylls med siffror och alla i rummet är nöjda. Sedan väljer den första riktiga kunden ett datum, ser ett lägre belopp på resultatsidan än på betalsidan och skriver till supporten med en skärmdump. Ingenting är trasigt. API:et gjorde precis det man bad om: det besvarade en fråga om pris, och webbplatsen behandlade svaret som ett löfte.

Ett pris är ett erbjudande med kort minne

En flygtaxa är ingen fast lapp på ett säte. Den är en bokningsklass som öppnas och stängs allteftersom platser säljs, och siffran som hör till den ändras med vilka som reser, de exakta flygningarna, skatterna på de berörda flygplatserna och den valuta offerten anges i. Ett prissvar är en ögonblicksbild tagen vid ett tillfälle för en uppsättning indata. Behandla det som ett faktum om det förflutna så bygger du rätt sak; behandla det som ett faktum om nuet så ägnar du en månad åt återbetalningar.

Den användbara frågan för en utvecklare är därför aldrig bara vad priset är. Den är vilken sorts pris det här är, hur gammalt det är och vad systemet gör om det visar sig vara fel.

Tre siffror som alla kallas pris

De flesta leverantörer returnerar alla tre någonstans i sin dokumentation, ofta under samma fältnamn. Håll isär dem i din egen datamodell från första dagen.

TillståndVarifrån det kommerHur färsktKan du sälja det?Vad som visas
SökprisCachad eller aggregerad sökning, byggd för fart och breddMöjligen föråldrad och inte beräknad för dina resenärerNejFormuleringen ”från” och en markering att det kan ändras
Prissatt erbjudandeEn live-förfrågan för exakt resväg, resenärstyper och taxaFärskt vid anropet, med utgångstid eller signal om ompriosättningJa, tills det löper utTotalbeloppet, specificerade skatter, taxevillkor
Utfärdat beloppVad flygbolaget eller utfärdande system faktiskt debiterade vid ordernSlutligtRedan såltKvittot; stäm av det mot erbjudandet

Sökpriset gör kalendrar och märket ”billigast från” möjliga, och det är bra att bygga. Det är bara inte samma objekt som den andra raden. Misstaget är ett enda fält som heter price som alla tre rinner in i.

I praktiken betyder det tre separata typer eller tabeller i koden, inte en med en flagga. Ett sökpris får vara fel i det lilla, eftersom det bara är en uppmaning att klicka. Ett prissatt erbjudande är ett åtagande du står i begrepp att göra i eget namn, så det sparas med tidpunkten då det hämtades, de indata som gav det och det identifierare leverantören vill ha tillbaka vid ordern. Det utfärdade beloppet är bokföring. När supporten frågar varför en kund betalade en annan siffra än den i mejlet ligger svaret i glappet mellan raderna, och det glappet kan du bara läsa om du sparat alla tre.

Vad ett prissvar måste innehålla

En naken siffra räcker inte för att bygga en kassa på. När du läser en leverantörs exempelsvar, leta efter följande och var misstänksam mot allt som kommer som fri text.

  • Valutan, angiven i svaret och inte antagen utifrån ditt konto.
  • Grundtaxa och skatter var för sig, så att du kan visa en specifikation och en skatteändring inte ser ut som en taxeändring.
  • Resenärstyperna som priset räknats för. Ett vuxenpris gånger tre är ingen familjetaxa.
  • Taxevillkor och bagage som strukturerad data, eftersom de avgör om ett billigt alternativ verkligen är billigare för kunden.
  • En signal om utgång eller ompriosättning: en tidsstämpel eller ett uttryckligt besked att du måste prissätta om före ordern.

Den sista punkten hoppar folk över. Om inget i svaret säger hur länge erbjudandet lever gissar du, och gissningen görs i produktion.

Prissätt om före ordern, inte efter den

Den säkraste rytmen har en regel i sig. Sök för att bläddra. När kunden väljer en resväg begär du ett live-prissatt erbjudande för exakt den resvägen och de resenärerna. Du visar kunden den totalsumman. Först därefter skapar du ordern. Om live-priset skiljer sig från det på resultatsidan säger du det till kunden före betalning, med enkla ord, inte efter.

Hoppar du över mellansteget ärver du skillnaden. Antingen tar du mer än kunden såg och förlorar försäljningen på betalsidan, eller så håller du det lägre priset och glappet tas ur din egen marginal. En liten byrå kan svälja det några gånger; den kan inte svälja det som design.

Fråga det här skriftligt innan du integrerar

Dokumentationen beskriver den lyckliga vägen. Beteendet som kostar pengar finns i svaren på en kort lista frågor, och svaren är värda att ha i ett mejl snarare än i ett samtal.

  1. Är priset i sökresultatet live eller cachat, och står det på själva svaret?
  2. Finns det ett separat prissättningsanrop för exakt resväg, och krävs det före en order?
  3. Vad händer vid order om priset har flyttat sig: ett avslag, ett nytt pris i svaret eller en tyst utfärdning till det nya beloppet?
  4. Hur specificeras skatter och bränsletillägg, och kan de ändras mellan prissättning och utfärdning?
  5. I vilken valuta räknas priset och var sker omräkningen om kunden ser en annan?
  6. Hur länge gäller ett prissatt erbjudande och hur får du veta det?

En leverantör som svarar exakt på dessa har tänkt på kassan. En som svarar ”det är alltid aktuellt” har inte sagt något du kan testa. Kan du inte prova beteendet själv är det ett skäl att se på hela upplägget på ett annat sätt innan du förbinder dig att bygga kring det.

Vad det kostar att göra fel

Det misslyckas sällan högljutt. Det misslyckas som ett litet tapp vid betalsteget som ingen skyller på priset, som supportärenden som börjar med ”priset ändrades”, som en kund som litade på resultatsidan och nu inte gör det. Personalen börjar bekräfta taxor för hand före utfärdning. Någon föreslår till slut en regel som avrundar priser uppåt för säkerhets skull, och webbplatsen blir dyr på just den skärm där folk jämför. Allt detta är en skatt på ett beslut som var billigt att ta rätt från början.

Var den här plattformen står

Plattformen exponerar flyg- och hotell-API:er, aktiverade per tenant. Åtkomsten börjar som ett samtal, inte som en självbetjäningsnyckel, så det finns inget registreringsformulär som ger dig en token och en tabell med gränser. Den här sidan publicerar inte latens, täckning eller antal taxor, eftersom en siffra vi inte kan visa hur du testar inte är värd att trycka. Det du kan göra är att ta med frågorna ovan till det samtalet och be att få se svaret för ett prissatt erbjudande, inte bara för en sökning. Om du är i det skedet är sidan om rese-API:er där det börjar.

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.