Obrir Booking.com, Airbnb o Expedia amb les dates ja posades

Per què un enllaç i no una API

Hi ha dues maneres d’oferir allotjament des d’una altra app: connectar-se al web de reserves per portar preus i disponibilitat, o obrir el seu cercador amb la cerca ja escrita. Kokai fa el segon, per tres motius:

• Les API no són obertes. L’API de Booking.com per mostrar la seva oferta (Demand API) demana, segons la seva documentació, estar donat d’alta com a soci afiliat gestionat (Managed Affiliate Partner). Les condicions de l’API d’Airbnb l’ofereixen dins de programes pensats sobretot per a serveis per a amfitrions, i Kokai no ha trobat cap via oberta per cercar allotjament des d’una altra app.
• Privacitat. Connectar-s’hi voldria dir que les dates i la destinació del teu viatge passen per un tercer cada vegada que mires la pantalla. Amb un enllaç, fins que no el toques no surt res del dispositiu.
• Funciona per a totes. Una adreça amb paràmetres és el que fa servir el mateix cercador de cada web quan prems «Cerca», i se’n pot construir una per a qualsevol sense acords.

El que es perd: els preus no arriben a l’app. Els veus a cada web i, si reserves, el PDF de la confirmació te’ls torna (mira PDF de reserves).

El format de cada web

El que va entre claus se substitueix per les dades de la cerca. La resta de paràmetres són fixos. L’idioma és el de l’app.

Els nou enllaços, per a Lisboa del 3 al 6 d’octubre

Aquests són els enllaços que genera Kokai per a Lisboa, amb el país conegut (Portugal), entrada el 3 d’octubre de 2026, sortida el 6 (tres nits), 2 viatgers i l’app en castellà. Són la sortida de la mateixa funció que fa servir l’app, no escrits a mà.

Als paràmetres, un espai s’escriu + i una coma, %2C. Al camí (Airbnb i Kayak), l’espai és %20: «San Sebastián» queda San%20Sebasti%C3%A1n. Si construeixes aquests enllaços en un altre programa, deixa que els codifiqui la seva biblioteca d’adreces.

Expedia, Hotels.com i Vrbo: «Ciutat, País»

Les tres webs del grup Expedia interpreten la destinació a la seva manera, i amb el nom de la ciutat tot sol es poden equivocar de lloc: en la comprovació, «Lisboa» sola va acabar a Gal·les. Amb «Lisboa, Portugal» troben la ciutat bona.

Per això Kokai hi afegeix el país en aquestes tres webs, i només en aquestes, quan es compleix tot això:

• la destinació del viatge està situada al mapa i el seu nom acaba en un país («Lisboa · Sintra, Portugal»);
• el que es cerca no porta ja una coma («Oporto, Portugal» es deixa tal com és);
• i no és el mateix país (cercar «Portugal» no dona «Portugal, Portugal»).

Si la destinació no està situada, l’enllaç va sense país: revisa la destinació al web abans de mirar resultats.

Agoda i Google Hoteles, a mitges

Agoda només llança la cerca amb el seu número intern de la ciutat. Amb el nom, obre la seva pàgina amb la destinació, les dates, les nits (los) i els adults al formulari, i falta tocar «Cerca».

Google Hoteles no llegeix les dates de paràmetres separats, però sí que les entén escrites a la cerca, com les teclejaria una persona. Kokai les escriu segons l’idioma:

El nombre de viatgers no s’entén escrit així, i no hi va. Tria’l a la pàgina de Google després d’obrir-la.

Les que es van provar i no hi són

Una web entra a la llista només si, en obrir l’enllaç, omple el que promet.

Com es va comprovar, i per què pot deixar de funcionar

El 14 de setembre de 2026 es va obrir cada enllaç a Chromium amb Lisboa, del 3 al 6 d’octubre i 2 adults, i es va mirar què omplia cada web: la destinació, les dues dates i els viatgers.

Cap d’aquestes webs publica aquests paràmetres com una cosa estable: són els del seu propi cercador i poden canviar sense avís. Per comprovar-ne un avui:

1. Copia l’enllaç d’exemple i obre’l en una finestra privada, perquè no hi influeixi una cerca anterior.
2. Mira si la destinació és la que esperaves (amb Expedia, que no sigui Gal·les) i si les dates i els viatgers hi són.
3. Si hi falta alguna cosa, fes la cerca a mà en aquell web i compara l’adreça que et deixa amb la de l’exemple.

Enllaços d’afiliat

Un enllaç d’afiliat és el mateix enllaç amb una marca de qui el comparteix, perquè el web li pagui una comissió si reserves. A tu no et costa més. Kokai està preparada per portar-ne, però només si l’app es compila amb aquests enllaços: sense aquesta configuració, els enllaços són exactament els d’aquí dalt.

Es configuren a VITE_AFILIADOS, un JSON amb una entrada per web, d’una d’aquestes dues maneres:

• Paràmetres que s’afegeixen a l’enllaç, els que et dona el programa quan t’hi dones d’alta. Els previstos són aid i label per a Booking.com, Allianceid i SID per a Trip.com i a per a Kayak; confirma’ls amb cada programa.
• Un embolcall: l’adreça d’una xarxa d’afiliats que redirigeix al web (Awin, Partnerize o Travelpayouts funcionen així), amb {url} on va l’enllaç codificat. Ha de començar per https://.

Un JSON mal escrit, o un embolcall sense {url} o que no sigui https, s’ignoren: els enllaços surten sense afiliat, mai trencats. I quan algun porta afiliat, l’app ho diu al costat: «Algunos son enlaces de afiliado: si reservas desde ellos, Kokai puede recibir una comisión, sin que te cueste más» («Alguns són enllaços d’afiliat: si reserves des d’aquests enllaços, Kokai pot rebre una comissió, sense que et costi més»).

Cada programa té les seves condicions, i gairebé tots demanen avisar al costat de l’enllaç. El grup Expedia (Expedia, Hotels.com, Vrbo) dona els enllaços del seu programa amb la seva pròpia eina. Avui Kokai no té decidit fer servir afiliats.

On són a Kokai

A la pantalla Alojamiento («Allotjament») de cada viatge: a cada targeta «Falta alojamiento para…» («Falta allotjament per a…»), amb aquelles nits ja posades, i al botó «Buscar en otras webs» («Cercar en altres webs»), que comença per les primeres nits sense allotjament. Una opció per decidir té «Ver precios en otras webs» («Veure preus en altres webs»), que cerca pel seu nom.

• «Dónde buscar» («On cercar») comença per la primera part de la destinació. Amb «Lisboa y Sintra», cada part surt com a drecera.
• «Entrada», «Salida» («Sortida») i «Viajeros» («Viatgers») es poden canviar abans d’obrir res. La sortida ha de ser com a mínim un dia després.
• Els enllaços s’obren al navegador. No surt res del dispositiu fins que en toques un.

Quan reservis, afegeix el PDF de la confirmació amb «Desde el PDF de la reserva» («Des del PDF de la reserva»): les dates, el preu i la cancel·lació es llegeixen sols, al dispositiu.

Preguntes freqüents

Fonts i referències

La documentació original del que se cita aquí, consultada en la data de revisió d’aquesta pàgina.

1. Demand API: requisits previs per provar l’API Booking.com for Developers
2. API Terms of Service Airbnb Help Center
3. Trip.com Affiliate Program Trip.com
4. Travel Creator Program (Expedia, Hotels.com, Vrbo) Expedia Group
5. KAYAK Affiliate Network KAYAK
6. Cercar hotels a Google Ajuda de Google Viatges
7. URLSearchParams MDN Web Docs
8. URL Standard: application/x-www-form-urlencoded WHATWG

Continua llegint

• AllotjamentCom Kokai organitza l’allotjament per nits: reserves, opcions per comparar, nits sense cobrir, reserves dobles, avisos de cancel·lació i l’adreça sense xarxa.
• Reserves en PDFQuè treu Kokai del PDF d’una reserva sense IA ni xarxa: 65 marques, 8 classes, etiquetes en 7 idiomes, dates, preu, cancel·lació, amb un exemple de Booking.com.
• Planificar un viatgeItinerari de cinc nits per Lisboa i Sintra preparat de principi a fi: llocs, allotjament, pla amb temps, documents, maleta, avisos i el mode En ruta.
• GuiesGuies pràctiques amb exemples: planificar un viatge pas a pas, quins documents portar sense connexió, llegir reserves en PDF i cercar allotjament amb dates.
• GlossariQuè és una geotanca, una estada, un localitzador, la histèresi del GPS o un PMTiles: 35 termes de viatges i mapes, amb les xifres que fa servir Kokai.