Gratis API for hotellbooking: hva du faktisk får

Det er torsdag ettermiddag, og demoen er på mandag. Du fant et gratis API for hotellbooking, registrerte deg med en e-postadresse og hadde en nøkkel på fem minutter. Søke-endepunktet returnerer hoteller med bilder, stjerner og en pris per natt. Utpå kvelden ser resultatsiden ut som den skal. Fredag kobler du på bookingkallet, og det svarer med en feil du ikke kan lese, fordi det du registrerte deg for aldri kunne lage en booking.
Ingen løy. «Gratis» henger rett og slett på fire ulike produkter i dette markedet, og registreringssidene forteller deg ikke hvilket du sitter med.
Fire ting «gratis» kan bety
Tabellen er verdt å ha ved siden av tastaturet. Er du uenig i en rad fordi leverandøren din gjør det annerledes, er også det et nyttig funn.
| Hva gratistilbudet er | Hva du får | Hva du kan bygge | Hva det ikke kan |
|---|---|---|---|
| Statisk innhold eller katalogdata | Hotellnavn, adresser, bilder, fasiliteter, beskrivelser | En hotellguide, et kart, en destinasjonsside | Vise en pris du kan stå inne for, eller et rom som faktisk er ledig på datoene dine |
| Affiliate-søk med videresending | Hoteller og priser og en lenke til selgerens egen kasse | En sammenligningsside som sender trafikken videre | Beholde kunden, betalingen eller bookingposten hos deg |
| Sandbox med testpriser | Hele søke-, pris-, booking- og avbestillingsflyten med oppdiktet utvalg | En fungerende integrasjon og en demo som oppfører seg som produksjon | Opprette en reservasjon et ekte hotell vil honorere |
| Live bookbare priser | Ekte rom til ekte netto- eller salgspriser, bekreftet av leverandøren | En butikk som tar betalt for rom | Være gratis for den som signerer kontrakten |
De tre første er gratis fordi det koster tilbyderen nesten ingenting å gi dem bort. Den fjerde er ikke gratis fordi noen bærer noe reelt.
Hvorfor en bookbar pris alltid kommer med en kontrakt
Når kunden din betaler for et rom, starter en kjede av forpliktelser. En leverandør har kontrakten med hotellet. Leverandøren har lovet hotellet at rommet blir betalt, og lovet deg at rommet finnes. Avbestiller gjesten etter fristen for gratis avbestilling, skylder noen hotellet en natt. Var prisen feil, tar noen differansen. Var kortet stjålet, hefter noen for tilbakeføringen.
Alt dette må lande hos en navngitt part. En API-nøkkel som hvem som helst kan generere med en e-postadresse, kan ikke bære det, og derfor følger bookbar tilgang med en avtale, en oppgjørsordning og ofte en kredittgrense. Prisen for den «gratis» nøkkelen er at tilbyderen slipper å bry seg om hva du gjør med den.
Ingenting av dette er kritikk av gratisnivåer. En innholdsfeed er helt riktig for en destinasjonsguide. Den blir feil først når den forveksles med det du trenger for å ta imot en booking.
Hvis du også vurderer hvor mange leverandører du trenger bak den du velger, gikk vi gjennom det i hvor mange hotell-API-leverandører du trenger; flyversjonen av samme forveksling står i de tre slagene gratis fly-API.
Det er enda en felle i første rad. Statisk innhold og live priser er to feeder med ulik levetid: et hotells beskrivelse kan ligge i cachen i uker, en pris for i natt kan ikke ligge der i minutter. En gratis innholdsfeed som også viser en pris, siterer et tall den ikke står inne for, og en side bygget på den viser fornøyd et rom som ble utsolgt i går.
Hva du tester i en sandbox før noen kontrakt signeres
En sandbox er det mest nyttige gratis i tabellen, så bruk den hardt. En god sandbox lar deg gjøre hvert trinn i en ekte booking, med falskt utvalg i riktig form.
- Søk med barn og flere rom. Belegg er stedet der enkle integrasjoner går i stykker først. Be om to rom med ulike gjester, og se om svaret holder dem adskilt.
- Prissjekk før booking. Mange leverandører forventer et andre kall som bekrefter at prisen fortsatt gjelder. Mangler sandboxen trinnet, spør om produksjon har det.
- Book, og les så hva som kommer tilbake. Et bekreftet rom, en ventende forespørsel og et rom på forespørsel er tre ulike utfall, og skjermen din må si hvilket.
- Endre prisen mellom søk og booking. Priser flytter seg. Hvordan ser feilen ut, og kan koden din vise kunden den nye prisen i stedet for en tom side?
- Avbestill innenfor og utenfor det gratis vinduet. Avbestillingsvilkårene bør komme som strukturerte data med datoer og beløp, ikke som et avsnitt du må tolke.
- Feil med vilje. Send en feil dato, en ukjent hotellkode, et utløpt token. Tell hvor mange ulike feilformer du får tilbake.
Klarer ikke sandboxen trinn fire og fem, har du et innholds-API med en bookingformet URL.
Hva det koster å bygge på feil type
Den dyre versjonen av feilen er ikke uken du taper. Det er demoen som går bra.
Du viser en interessent en ren søkeside, de godkjenner budsjettet, og først da oppdager teamet at kilden bak ikke kan bekrefte et rom. Koden er ikke helt bortkastet, men bookingflyten, betalingstrinnet, avbestillingshåndteringen og oppgjøret må bygges mot en annen leverandør med andre feltnavn. Søkesiden du viste, vil da returnere andre hoteller, til andre priser, i en annen rekkefølge. Den som godkjente budsjettet, kommer til å merke det.
Den billigere vanen er å stille ett spørsmål før du skriver kode: «Kan denne nøkkelen opprette en reservasjon et hotell vil honorere, og avbestille den etterpå?» Er svaret noe annet enn ja, vet du hvilken av de fire du sitter med.
Hvor denne plattformen står
Vi bør være like rett fram om vår egen posisjon som vi har vært om de andres. Plattformen tilbyr fly- og hotell-API-er, og tilgang starter som en samtale heller enn en selvbetjent nøkkel. Det er rad fire i tabellen: bak bookbart utvalg står noen som må vite hvem som spør. Vil du se hvordan det fungerer for ditt eget prosjekt, start med siden om reise-API-ene og fortell oss hva du bygger.
Gratis innhold, affiliate-lenker og sandboxer har alle sin plass, og riktig valg avhenger av hva du skal selge. Velg etter hva nøkkelen kan den dagen en kunde betaler.