Un enllaç de reserva ja emplenat
Una sola adreça obre el nostre formulari de reserva amb la ruta, l'hora, la classe i la resta ja posats. La persona ho comprova i paga; seguir l'enllaç no reserva res.
És per a qui ens envia gent amb la reserva ja acordada: un assistent que respon «reserva'm un trasllat de l'aeroport de Barcelona a Sitges», la recepció d'un hotel, un web associat. Els paràmetres de sota s'afegeixen a /{llengua}/book.
Els paràmetres
| Paràmetre | Què és | Exemple |
|---|---|---|
| from | Punt de recollida, en coordenades. L'únic obligatori. | 41.2971,2.0785 |
| from_label | Què mostrar al camp de recollida. Sense ell s'hi mostren les coordenades. | Barcelona Airport (BCN) |
| from_kind | Quina mena de lloc és la recollida: airport, city, station o cruise-port. Amb això el formulari demana el número de vol també en un viatge normal. | airport |
| to | Destinació. Si s'omet, el formulari obre aquest camp buit. | 41.2366,1.8059 |
| to_label | Què mostrar al camp de destinació. | Sitges |
| when | Hora de recollida, amb desplaçament horari. Sense ella, el viatge surt al més aviat possible. | 2026-09-25T09:30:00+02:00 |
| passengers | Quantes persones viatgen. Es tria la classe més petita on hi caben. | 4 |
| bags | Quants embalums d'equipatge. S'usa igual. | 3 |
| class | La classe de vehicle, pel seu nom al fitxer llegible per màquina. Mana sobre el nombre de passatgers. | comfort |
| extras | Serveis opcionals, pels identificadors del fitxer llegible per màquina. | 1,2 |
| flight | Número de vol per a una recollida a l'aeroport. Arriba al conductor. | VY1234 |
| utm_source | D'on ve l'enllaç. Hi posi el seu nom, vegi més avall. | your-assistant |
Abans de construir un enllaç
- Res de l'enllaç no és fatal. Un paràmetre que no podem llegir només costa aquell camp: el formulari s'obre igualment, emplenat amb tota la resta.
- Un grup més gran que el nostre cotxe més gran no queda en silenci: el formulari obre la classe més gran que venem i la pàgina avisa que la reserva necessita més d'un cotxe - reservar aquest cotxe i repetir la reserva per a la resta, o escriure'ns.
- La llengua és la primera part de l'adreça. /es/book obre el formulari en castellà, i no hi ha cap paràmetre de llengua.
- Els punts són coordenades, no noms de lloc. Resolgui abans l'adreça, o porti la persona a la pàgina de la ruta.
- La recollida ha de ser a Espanya. Un enllaç amb una recollida fora obre el formulari, i la comanda es rebutja en confirmar-la.
- Els paràmetres només s'afegeixen: no se'n reanomena ni se'n retira cap. Un enllaç fet avui continuarà funcionant.
La mateixa reserva, en sis llengües
Aeroport de Barcelona a Sitges, el 25 de setembre a dos quarts de deu, quatre persones, tres maletes, Comfort, vol VY1234.
Digui d'on ve
Posi utm_source a l'enllaç amb el seu nom, perquè una reserva feta per aquí es pugui distingir d'una adreça escrita a mà. La marca es desa amb la comanda un cop el visitant accepta les galetes; sense consentiment la reserva funciona igual i no porta cap marca.
El mateix, per a una màquina
Tots els paràmetres, les classes de vehicle amb les seves places i els serveis opcionals amb els seus identificadors, en JSON. Llegeixi'l en comptes d'endevinar el nom d'una classe.
https://letsgo-transfer.com/booking-link.jsonPreus i reservar per API
No hi ha cap endpoint per crear una reserva: pagar amb targeta demana una pantalla i una persona, de manera que el traspàs acaba en aquest enllaç igualment. El preu sense iniciar sessió és un endpoint a part que només respon a un testimoni de servei que emetem nosaltres, així que parli amb nosaltres abans de construir-hi a sobre.
POST /api/orders/quote