Saltar al contingut
Per a desenvolupadors

Construeix comerç hoteler dins del teu producte.

Section titled “Construeix comerç hoteler dins del teu producte.”

Comerç hoteler API-first: cerca, reserva, pagament, 70 webhooks, atribució i transferència AI — amb un servidor MCP allotjat perquè els agents llegeixin els contractes en viu, i Booking Engine que compleix a sota.

REST + OAuth2 + SDKs Servidor MCP allotjat 70 esdeveniments webhook
wink · agent integration live

# 1 · connect an agent or coding client

$ claude mcp add wink

https://api.wink.travel/mcp --transport http

→ browser sign-in at iam.wink.travel

✓ connected · OAuth2 + PKCE · no client secret

# 2 · find the operation, read the live contract

api_search "create booking"

→ POST /bookings · wink://api/operation/createBooking

# 3 · create the booking, take payment

$ wink bookings create --rate rp_8421

201 · #WK-2X9F · paid via Wink

# 4 · react in real time

on booking.create → fulfill & reconcile

Què poden construir els desenvolupadors amb Wink?

Els desenvolupadors poden construir fluxos de cerca hotelera, reserva, pagament, webhook, atribució, informes, transferència AI i comerç incrustat dins dels seus propis productes. L’accés per a desenvolupadors de Wink funciona amb oferta controlada per l’hotel des de l’Extranet, context de socis de la xarxa subjacent, transferència AI a través d’Agentic AI, i compliment amb Booking Engine per al procés de pagament, confirmació i finalització de la reserva específica de l’hotel.

Per a qui és

Per a equips que construeixen comerç hoteler, no només llegeixen documentació.

Section titled “Per a equips que construeixen comerç hoteler, no només llegeixen documentació.”

L’accés per a desenvolupadors s’adapta a equips de producte, enginyeria, AI, plataforma i operacions. Esteu avaluant una integració per a un producte AI, banc o superapp? Vegeu Per a plataformes i AI.

Equips de producte

Afegiu comerç hoteler a una app o plataforma existent via accés per a desenvolupadors + Booking Engine.

Equips de producte AI

Dirigiu la intenció hotelera guiada per assistents a fluxos de reserva controlats amb Agentic AI i el servidor MCP.

Agències i DMCs

Construeix aparadors personalitzats, fluxos de reserva o productes d'itinerari amb Web Components.

Gestor de canals / PMS

Coordina disponibilitat, tarifes, reserves i fluxos d'esdeveniments relacionats.

Per què construir-hi

Una targeta d’hotel és fàcil. Un sistema de reserves hoteler no ho és.

Section titled “Una targeta d’hotel és fàcil. Un sistema de reserves hoteler no ho és.”

El comerç hoteler necessita regles d’oferta, disponibilitat, tarifes, ofertes, polítiques, procés de pagament, confirmació, atribució i informes. Construeix sobre aquestes capes en lloc de tornar-les a crear.

  • Reconstrueix regles d'oferta, tarifes i polítiques
  • Connecta el procés de pagament a dades específiques de l'hotel
  • Enllaça l'atribució entre sessions
  • Gestiona pagaments, reemborsaments i conciliacions
  • Controla l'AI perquè no inventi disponibilitat
  • Mantén-ho tot mentre els hotels canvien diàriament
  • Integra oferta aprovada per l'hotel des de l'Extranet
  • Booking Engine gestiona el procés de pagament, confirmació i checkout
  • Atribució preservada durant 6 mesos per clic
  • Subscriu-te a 70 esdeveniments webhook
  • Transferència AI estructurada via MCP + Agentic AI
  • 1,5% + cost de processament — Booking Engine sota cada transferència

El model

Des de la primera crida fins a la reserva confirmada.

Section titled “Des de la primera crida fins a la reserva confirmada.”

Un camí d’integració des de la connexió fins al compliment.

  1. 1

    Connecta

    Afegeix el servidor MCP allotjat o crea credencials OAuth2 per començar amb contractes en viu.

  2. 2

    Llegeix contractes en viu

    Operacions de cerca i lectura dels esquemes actuals de petició i resposta — sense endevinalles ni documentació obsoleta.

  3. 3

    Construeix el flux

    Connecta cerca, disponibilitat, reserva, pagament i informes dins del teu producte.

  4. 4

    Subscriu-te a esdeveniments

    Reacciona a 70 esdeveniments webhook: estat de la reserva, pagaments, reemborsaments, cancel·lacions i canvis de canal.

  5. 5

    Completa amb Booking Engine

    Cada crida es resol amb Booking Engine per al procés de pagament, confirmació i checkout específics de l'hotel.

Per a agents AI — comenceu aquí

Connecta, després llegeix els contractes en viu.

Section titled “Connecta, després llegeix els contractes en viu.”

Un servidor MCP allotjat permet a un agent descobrir les APIs de Wink i construir una integració funcional sense endevinar els punts finals.

Punt final HTTP transmissible (SSE fallback a /sse). Des de Claude Code:

claude mcp add —transport http 
wink-docs https://docs.mcp.wink.travel/mcp

També funciona amb Codex, Cursor i VS Code — vegeu la documentació MCP.

Dues eines resolen la intenció en operacions reals i documentació conceptual:

  • api_searchtroba l’operació a cridar — per exemple “consulta inventari”, “crea reserva”, “rebut de pagament”
  • docs_searchtroba conceptes — “autenticació”, “webhooks”, “atribució”

Cada resultat retorna un URI wink:// — obre l’operació, el seu esquema de petició/resposta, o la seva recepta de tasca.

wink-api-builder utilitza el servidor MCP com a font de veritat: api_search → contractes en viu → autenticació → codi verificat, i marca qualsevol desajust amb l’API actual.

Funciona amb Claude Code, Codex i Cursor — vegeu AI Skills.

Crea la reserva via l’API i Booking Engine la compleix — checkout, pagament, confirmació i sincronització de la reserva amb el PMS o gestor de canals connectat, preservant el context d’origen.

Subscriu-te a booking.create i 63 altres esdeveniments per reaccionar en temps real.

Un motor, totes les integracions

Totes les integracions convergeixen a Booking Engine.

Section titled “Totes les integracions convergeixen a Booking Engine.”

Sigui com sigui que el teu producte enviï la demanda — API, agent, component o enllaç — la reserva es resol en un sol lloc que controles.

  • REST API
  • MCP / agents
  • Web Components
  • WinkLinks
  • Studio + network
  • Partner apps

Booking Engine

checkout · payment · confirmation

Reserva confirmada

Pagament realitzat, hoste confirmat, atribució i context d'origen preservats.

Tot l’abast

Des d’una construcció completa d’API fins a un component per inserir.

Section titled “Des d’una construcció completa d’API fins a un component per inserir.”

Ves tan a fons com una integració completa REST + MCP — o, quan això és més del que necessita la feina, insereix un Web Component de Studio: targetes d’hotel, mapes, graelles i mòduls de reserva. En qualsevol cas, Booking Engine compleix la reserva a sota.

  • API REST + OAuth2 completa, servidor MCP allotjat i clients generats
  • O Web Components reservables — targetes, mapes i graelles
  • 70 esdeveniments webhook per a conciliació en temps real
  • Compliment amb Booking Engine sota cada superfície
Veure la documentació Build on Wink
Un Web Component de targeta d'hotel incrustable de Wink

Preguntes freqüents per a desenvolupadors

Què pregunten primer els equips tècnics i de producte.

Hi ha una pàgina de producte separada per a l'accés a l'API?
No. L'accés a l'API es gestiona a través de la pàgina Builders i la documentació Build on Wink, no a través d'una pàgina de producte de màrqueting independent.
L'accés a l'API substitueix Booking Engine?
No. L'accés a l'API gestiona la demanda i la lògica d'integració. Booking Engine continua sent la capa de compliment per al procés de pagament, confirmació i finalització de la reserva específica de l'hotel.
Els assistents AI poden utilitzar Wink?
Sí. Un servidor MCP allotjat permet als agents AI llegir els contractes en viu de l'API per poder cercar l'oferta hotelera en temps real, crear reserves i efectuar el pagament a través de Booking Engine — completant una reserva en un sol flux, no només redirigint l'usuari a un lloc web. Qualsevol hotel està preparat per a agents un cop el seu perfil està actiu a Wink.
Puc incrustar targetes d'hotel o mapes sense una integració completa d'API?
Sí. Studio pot crear Web Components com targetes d'hotel, mapes, graelles i altres actius incrustats quan una ruta de menor esforç és suficient — Booking Engine compleix la reserva a sota.
Els grups hotelers poden utilitzar l'accés per a desenvolupadors?
Sí. Els grups hotelers i operadors tècnics poden utilitzar l'accés per a desenvolupadors per connectar l'oferta, la reserva i els fluxos d'informes de Wink amb sistemes interns.
Per on han de començar els desenvolupadors?
Connecteu-vos al servidor MCP, llegiu la documentació Build on Wink, després creeu credencials OAuth2 i comenceu a desenvolupar en l'entorn de proves — sense sol·licitud d'accés ni esperes. Quan estigueu preparats, creeu una aplicació en producció i apunteu el vostre codi a les URL de producció.
L'accés per a desenvolupadors està obert a tothom?
Sí. La documentació i el servidor MCP són públics, i qualsevol desenvolupador pot crear credencials OAuth2 i començar a desenvolupar en l'entorn de proves sense demanar-nos-ho. Passar a producció tampoc necessita aprovació. Només els gestors de canals i agents de viatges passen per certificació.

Preparat per construir comerç hoteler dins del teu producte?

Section titled “Preparat per construir comerç hoteler dins del teu producte?”

Connecta el servidor MCP, llegeix la documentació, tria la superfície d’integració adequada. Res no està bloquejat — comença quan el teu producte estigui preparat per connectar la demanda hotelera aprovada amb el compliment de Booking Engine.