API til flypriser: hvorfor tallet endnu ikke er en pris, du kan sælge

Demoen virker. En udvikler kobler et API til flypriser på en kalender over de billigste rejsedage, gitteret fyldes med tal, og alle i lokalet er glade. Så vælger den første rigtige kunde en dato, ser et lavere beløb på resultatsiden end på betalingssiden og skriver til supporten med et skærmbillede. Intet er ødelagt. API'et gjorde præcis, hvad det blev bedt om: det besvarede et spørgsmål om pris, og siden behandlede svaret som et løfte.
En pris er et tilbud med kort hukommelse
En flytakst er ikke en fast etiket på et sæde. Den er en bookingklasse, der åbner og lukker, efterhånden som sæderne sælges, og tallet knyttet til den ændrer sig med passagersammensætningen, de præcise afgange, afgifterne i de berørte lufthavne og den valuta, tilbuddet er opgjort i. Et prissvar er et øjebliksbillede taget på ét tidspunkt for ét sæt input. Behandl det som en kendsgerning om fortiden, og du bygger det rigtige; behandl det som en kendsgerning om nutiden, og du bruger en måned på refusioner.
Det nyttige spørgsmål for en udvikler er derfor aldrig kun, hvad prisen er. Det er, hvilken slags pris det her er, hvor gammel den er, og hvad systemet gør, hvis den viser sig at være forkert.
Tre tal, der alle hedder pris
De fleste leverandører returnerer alle tre et sted i deres dokumentation, ofte under samme feltnavn. Hold dem adskilt i din egen datamodel fra første dag.
| Tilstand | Hvor den kommer fra | Hvor frisk | Kan du sælge den? | Hvad du viser |
|---|---|---|---|---|
| Søgepris | Cachet eller aggregeret søgning bygget til hastighed og bredde | Muligvis forældet og ikke beregnet til dine passagerer | Nej | Formuleringen "fra" og en markering af, at den kan ændre sig |
| Prissat tilbud | En live-forespørgsel på den præcise rejse, passagertyper og takst | Frisk ved kaldet, med udløb eller signal om genberegning | Ja, indtil det udløber | Totalen, specificerede afgifter, takstregler |
| Udstedt beløb | Hvad flyselskabet eller udstedelsessystemet faktisk opkrævede ved ordren | Endeligt | Allerede solgt | Kvitteringen; afstem den mod tilbuddet |
Søgeprisen gør kalendere og mærket "billigst fra" mulige, og det er godt at bygge. Den er bare ikke det samme objekt som anden række. Fejlen er ét enkelt felt kaldet price, som alle tre løber ind i.
I praksis betyder det tre adskilte typer eller tabeller i koden, ikke én med et flag. En søgepris må gerne være forkert i det små, fordi den kun er en opfordring til at klikke. Et prissat tilbud er en forpligtelse, du er ved at påtage dig i eget navn, så det gemmes med tidspunktet for hentning, de input, der gav det, og den identifikator, leverandøren vil have tilbage ved ordren. Det udstedte beløb er regnskab. Når supporten spørger, hvorfor en kunde betalte et andet tal end det i mailen, ligger svaret i kløften mellem rækkerne, og den kløft kan du kun læse, hvis du har gemt alle tre.
Hvad et prissvar skal indeholde
Et nøgent tal er ikke nok til at bygge en kasse på. Når du læser en leverandørs eksempelsvar, så led efter følgende, og vær mistænksom over for alt, der kommer som fri tekst.
- Valutaen, angivet i svaret og ikke antaget ud fra din konto.
- Grundtakst og afgifter hver for sig, så du kan vise en specifikation, og en afgiftsændring ikke ligner en taksændring.
- Passagertyperne, prisen er beregnet til. En voksenpris gange tre er ikke en familietakst.
- Takstregler og bagage som struktureret data, fordi de afgør, om en billig mulighed virkelig er billigere for kunden.
- Et signal om udløb eller genberegning: et tidsstempel eller en udtrykkelig besked om, at du skal genberegne før ordren.
Det sidste punkt springer folk over. Hvis intet i svaret siger, hvor længe tilbuddet lever, gætter du, og gættet foregår i produktion.
Genberegn før ordren, ikke efter
Den sikreste rytme har en regel i sig. Søg for at browse. Når kunden vælger en rejse, beder du om et live-prissat tilbud på netop den rejse og de passagerer. Du viser kunden den total. Først derefter opretter du ordren. Hvis live-prisen afviger fra den på resultatsiden, fortæller du kunden det før betalingen, i almindelige ord, ikke bagefter.
Springer du mellemtrinnet over, arver du forskellen. Enten opkræver du mere, end kunden så, og mister salget på betalingssiden, eller du overholder det lavere tal, og hullet tages af din egen avance. Et lille bureau kan sluge det et par gange; det kan ikke sluge det som design.
Spørg om det her skriftligt, før du integrerer
Dokumentationen beskriver den lykkelige vej. Den adfærd, der koster penge, ligger i svarene på en kort liste spørgsmål, og svarene er værd at have i en mail frem for i et opkald.
- Er prisen i søgesvaret live eller cachet, og står det på selve svaret?
- Findes der et separat prisopslag for den præcise rejse, og er det påkrævet før en ordre?
- Hvad sker der ved ordren, hvis prisen har rykket sig: en afvisning, en ny pris i svaret eller en tavs udstedelse til det nye beløb?
- Hvordan specificeres afgifter og brændstoftillæg, og kan de ændre sig mellem prisopslag og udstedelse?
- I hvilken valuta beregnes prisen, og hvor sker omregningen, hvis kunden ser en anden?
- Hvor længe gælder et prissat tilbud, og hvordan får du det at vide?
En leverandør, der svarer præcist på dem, har tænkt over kassen. En, der svarer "den er altid opdateret", har ikke sagt noget, du kan teste. Kan du ikke selv afprøve adfærden, er det en grund til at se anderledes på hele opsætningen, før du forpligter dig til at bygge omkring den.
Hvad det koster at gøre det forkert
Det fejler sjældent højlydt. Det fejler som et lille fald ved betalingstrinnet, som ingen tilskriver prisen, som supporthenvendelser, der begynder med "prisen ændrede sig", som en kunde, der stolede på resultatsiden og nu ikke gør det mere. Personalet ender med at genbekræfte takster i hånden før udstedelse. Til sidst foreslår nogen en regel, der runder priserne op for en sikkerheds skyld, og så er siden dyr på netop den skærm, hvor folk sammenligner. Hver eneste af dem er en skat på en beslutning, der var billig at tage rigtigt fra start.
Hvor denne platform står
Platformen udstiller fly- og hotel-API'er, aktiveret pr. tenant. Adgang starter som en samtale frem for en selvbetjeningsnøgle, så der er ingen tilmeldingsformular, der giver dig et token og en tabel med grænser. Denne side offentliggør ikke latenstid, dækning eller antal takster, fordi et tal, vi ikke kan vise dig, hvordan du tester, ikke er værd at trykke. Du kan tage spørgsmålene ovenfor med til den samtale og bede om at se svaret for et prissat tilbud, ikke kun for en søgning. Er du på det trin, er siden om rejse-API'er der, hvor det starter.