API for flypriser: hvorfor tallet ennå ikke er en pris du kan selge

Demoen fungerer. En utvikler kobler et API for flypriser til en kalender over de billigste reisedagene, rutenettet fylles med tall, og alle i rommet er fornøyde. Så velger den første ekte kunden en dato, ser et lavere beløp på resultatsiden enn på betalingssiden og skriver til kundestøtten med et skjermbilde. Ingenting er ødelagt. API-et gjorde nøyaktig det det ble bedt om: det svarte på et spørsmål om pris, og nettstedet behandlet svaret som et løfte.
En pris er et tilbud med kort hukommelse
En flytakst er ikke en fast lapp på et sete. Den er en bookingklasse som åpner og lukker seg etter hvert som setene selges, og tallet knyttet til den endrer seg med passasjersammensetningen, de nøyaktige flyvningene, avgiftene på de berørte flyplassene og valutaen tilbudet er oppgitt i. Et prissvar er et øyeblikksbilde tatt på ett tidspunkt for ett sett med inndata. Behandler du det som et faktum om fortiden, bygger du det riktige; behandler du det som et faktum om nåtiden, bruker du en måned på refusjoner.
Det nyttige spørsmålet for en utvikler er derfor aldri bare hva prisen er. Det er hva slags pris dette er, hvor gammel den er, og hva systemet gjør hvis den viser seg å være feil.
Tre tall som alle kalles pris
De fleste leverandører returnerer alle tre et sted i dokumentasjonen, ofte under samme feltnavn. Hold dem adskilt i din egen datamodell fra første dag.
| Tilstand | Hvor den kommer fra | Hvor fersk | Kan du selge den? | Hva du viser |
|---|---|---|---|---|
| Søkepris | Bufret eller aggregert søk bygget for fart og bredde | Muligens utdatert og ikke beregnet for dine passasjerer | Nei | Formuleringen «fra» og en merknad om at den kan endre seg |
| Priset tilbud | En live-forespørsel for nøyaktig reiserute, passasjertyper og takst | Fersk ved kallet, med utløp eller signal om ny prising | Ja, til det utløper | Totalen, spesifiserte avgifter, takstregler |
| Utstedt beløp | Hva flyselskapet eller utstedelsessystemet faktisk belastet ved bestillingen | Endelig | Allerede solgt | Kvitteringen; avstem den mot tilbudet |
Søkeprisen gjør kalendere og merket «billigst fra» mulig, og det er bra å bygge. Den er bare ikke det samme objektet som rad to. Feilen er ett enkelt felt kalt price som alle tre renner inn i.
I praksis betyr det tre adskilte typer eller tabeller i koden, ikke én med et flagg. En søkepris kan godt være feil i det små, fordi den bare er en oppfordring til å klikke. Et priset tilbud er et løfte du er i ferd med å gi i eget navn, så det lagres med tidspunktet det ble hentet, inndataene som ga det og identifikatoren leverandøren vil ha tilbake ved bestillingen. Det utstedte beløpet er regnskap. Når kundestøtten spør hvorfor en kunde betalte et annet tall enn det i e-posten, ligger svaret i gapet mellom radene, og det gapet kan du bare lese hvis du har beholdt alle tre.
Hva et prissvar må inneholde
Et bart tall er ikke nok til å bygge en kasse på. Når du leser en leverandørs eksempelsvar, se etter følgende, og vær mistenksom overfor alt som kommer som fri tekst.
- Valutaen, oppgitt i svaret og ikke antatt ut fra kontoen din.
- Grunntakst og avgifter hver for seg, slik at du kan vise en oppdeling og en avgiftsendring ikke ser ut som en taksendring.
- Passasjertypene prisen er beregnet for. En voksenpris ganget med tre er ikke en familietakst.
- Takstregler og bagasje som strukturerte data, fordi de avgjør om et billig alternativ virkelig er billigere for kunden.
- Et signal om utløp eller ny prising: et tidsstempel eller en uttrykkelig beskjed om at du må prise på nytt før bestillingen.
Det siste punktet hopper folk over. Hvis ingenting i svaret sier hvor lenge tilbudet lever, gjetter du, og gjettingen skjer i produksjon.
Pris på nytt før bestillingen, ikke etter
Den tryggeste rytmen har en regel i seg. Søk for å bla. Når kunden velger en reiserute, ber du om et live-priset tilbud for akkurat den ruten og de passasjerene. Du viser kunden den totalen. Først deretter oppretter du bestillingen. Hvis live-prisen avviker fra den på resultatsiden, sier du det til kunden før betaling, med enkle ord, ikke etter.
Hopper du over mellomtrinnet, arver du forskjellen. Enten tar du mer enn kunden så og mister salget på betalingssiden, eller du holder det lavere tallet og gapet tas fra din egen margin. Et lite byrå kan svelge det noen ganger; det kan ikke svelge det som design.
Spør om dette skriftlig før du integrerer
Dokumentasjonen beskriver den lykkelige veien. Atferden som koster penger, ligger i svarene på en kort liste spørsmål, og svarene er verdt å ha i en e-post fremfor i en samtale.
- Er prisen i søkesvaret live eller bufret, og står det på selve svaret?
- Finnes det et eget prisoppslag for nøyaktig reiserute, og er det påkrevd før en bestilling?
- Hva skjer ved bestilling hvis prisen har flyttet seg: et avslag, en ny pris i svaret eller stille utstedelse til det nye beløpet?
- Hvordan spesifiseres avgifter og drivstofftillegg, og kan de endre seg mellom prising og utstedelse?
- I hvilken valuta beregnes prisen, og hvor skjer omregningen hvis kunden ser en annen?
- Hvor lenge er et priset tilbud gyldig, og hvordan får du vite det?
En leverandør som svarer presist på disse, har tenkt på kassen. En som svarer «den er alltid oppdatert», har ikke sagt noe du kan teste. Kan du ikke prøve atferden selv, er det en grunn til å se på hele oppsettet på en annen måte før du forplikter deg til å bygge rundt det.
Hva det koster å gjøre det feil
Det feiler sjelden høylytt. Det feiler som et lite fall på betalingssteget som ingen skylder på prisen, som støttesaker som begynner med «prisen endret seg», som en kunde som stolte på resultatsiden og nå ikke gjør det lenger. De ansatte ender opp med å bekrefte takster for hånd før utstedelse. Til slutt foreslår noen en regel som runder prisene opp for sikkerhets skyld, og da er nettstedet dyrt på akkurat den skjermen der folk sammenligner. Alt dette er en skatt på en beslutning som var billig å ta riktig fra starten.
Hvor denne plattformen står
Plattformen tilbyr fly- og hotell-API-er, aktivert per tenant. Tilgang starter som en samtale, ikke en selvbetjent nøkkel, så det finnes intet registreringsskjema som gir deg en token og en tabell med grenser. Denne siden publiserer ikke ventetid, dekning eller antall takster, fordi et tall vi ikke kan vise deg hvordan du tester, ikke er verdt å trykke. Du kan ta spørsmålene ovenfor med til den samtalen og be om å få se svaret for et priset tilbud, ikke bare for et søk. Er du på det stadiet, er siden om reise-API-er stedet det starter.