Les quatre capacitats que importen
Section titled “Les quatre capacitats que importen”| Capacitat | Què significa | Per què els productes s’aturen sense això |
|---|---|---|
| Tarifes i disponibilitat en viu | Preus actuals i què és realment reservable, per rang de dates | Les tarifes en memòria cau fallen a la confirmació i erosionen la confiança |
| Creació de reserva | Crear una reserva real que l’hotel rep | Sense això, només ets un enllaç de referència, no un producte |
| Pagament | Acceptar diners com a part de la reserva | Un traspàs a un altre lloc és on mor la conversió |
| Confirmació i webhooks | Informar el client, l’hotel i el teu sistema del que ha passat | Suportar la càrrega i evitar buits de conciliació |
La majoria d’“APIs d’hotels” que troba un desenvolupador cobreixen la primera i a vegades la segona. La transacció és la part difícil, i és la que decideix si tens un producte.
De qui és l’oferta que estàs integrant?
Section titled “De qui és l’oferta que estàs integrant?”Aquesta pregunta condiciona tot el que ve després. L’oferta revenduda a través d’una cadena arriba amb un marge dins la tarifa, disponibilitat més obsoleta i sense ruta de retorn a l’hotel per a preguntes sobre la reserva. L’oferta que prové directament de l’hotel porta la tarifa pròpia de l’hotel, disponibilitat en viu i un hotel que sap que la reserva existeix.
Per a qualsevol cosa on el viatger compari amb la web pròpia de l’hotel — que és la majoria — l’oferta controlada per l’hotel evita el moment incòmode quan el teu preu és pitjor.
Qui és el comerciant registrat
Section titled “Qui és el comerciant registrat”Si construeixes la reserva d’hotels tu mateix, convertir-te en comerciant registrat significa assumir la responsabilitat del pagament, devolucions, reemborsaments, gestió d’impostos i sovint una llicència d’agència de viatges a cada mercat.
A Wink, l’hotel continua sent el comerciant registrat i el pagament es recull per a l’hotel, així que un integrador no hereta aquesta responsabilitat. Els acords de comerciant registrat estan disponibles en integracions API on un soci realment necessita acceptar el pagament, i aquesta via comporta els seus propis requisits de llicència.
Tres nivells d’integració
Section titled “Tres nivells d’integració”- Components web. Inserir una cerca reservable, llista d’habitacions o procés de pagament en una pàgina existent. Sense treball de backend; menys control sobre el disseny.
- REST API. Control total sobre la cerca, tarifes, creació de reserva i confirmació, autenticat amb OAuth2. S’utilitza quan el flux de reserva forma part de l’experiència pròpia del producte.
- Servidor MCP. Les mateixes capacitats exposades per a agents d’IA, perquè un assistent pugui cercar, valorar i completar una reserva en lloc de redirigir l’usuari a una web.
Els tres no són excloents — un producte normalment usa components per a una superfície de màrqueting i l’API per al seu flux principal.
Què construir primer
Section titled “Què construir primer”- Cerca i preu per a una ciutat i un rang de dates. Obteniu tarifes reals abans de dissenyar res.
- Crea una reserva de prova completa, incloent pagament i confirmació.
- Subscriu-te a
booking.createi als esdeveniments de cancel·lació abans de construir qualsevol UI a sobre. - Decideix el teu model d’atribució aviat — el context de la font ha de viatjar amb la reserva, o després els informes seran especulatius.
- Gestiona els casos de fallada: disponibilitat perduda entre la cotització i la reserva, pagament rebutjat, reemborsaments parcials.
Preus que un desenvolupador hauria de conèixer
Section titled “Preus que un desenvolupador hauria de conèixer”Les APIs Consumer i Booking Engine són gratuïtes. L’API Partner inclou una franquícia mensual gratuïta de 10.000 nits d’hotel, després factura per unitat. Les reserves confirmades porten la comissió de plataforma de l’hotel del 1,5% més el cost del processament de targetes, i s’aplica una comissió per defecte del 10% quan el teu producte ha generat la reserva — que és com un integrador guanya en lloc de pagar.
Errors comuns
Section titled “Errors comuns”- Construir sobre tarifes en memòria cau. Sembla bé en desenvolupament i falla en producció.
- Deixar el pagament a una redirecció. Cada traspàs perd reserves.
- Ignorar els webhooks fins al llançament. La conciliació esdevé una feina manual.
- Convertir-se en comerciant registrat sense necessitat. És una decisió de llicència i responsabilitat, no només tècnica.
- No passar el context de la font. L’atribució no es pot reconstruir després.