Pular para o conteúdo
Para Desenvolvedores

Comércio hoteleiro API-first: pesquisa, reserva, pagamento, 64+ webhooks, atribuição e transferência AI — com um servidor MCP alojado para que agentes leiam os contratos ao vivo, e o Booking Engine a cumprir por baixo.

REST + OAuth2 + SDKs Servidor MCP alojado 64+ eventos 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.created fulfill & reconcile

O que os desenvolvedores podem construir com o Wink?

Os desenvolvedores podem construir fluxos de trabalho de pesquisa hoteleira, reserva, pagamento, webhook, atribuição, relatórios, transferência AI e comércio incorporado em produtos aprovados. O acesso para desenvolvedores Wink funciona com oferta controlada pelo hotel a partir do Extranet, contexto de parceiros da rede subjacente, transferência AI através do Agentic AI, e cumprimento pelo Booking Engine para checkout, pagamento, confirmação e conclusão de reservas específicas de hotéis.

Para quem é

Para equipas a construir comércio hoteleiro, não apenas a ler documentação.

Seção intitulada “Para equipas a construir comércio hoteleiro, não apenas a ler documentação.”

O acesso para desenvolvedores é adequado para equipas de produto, engenharia, AI, plataforma e operações. A avaliar uma integração para um produto AI, banco ou super app? Veja Para Plataformas & AI.

Equipas de produto

Adicione comércio hoteleiro a uma app ou plataforma existente via acesso para desenvolvedores + Booking Engine.

Equipas de produto AI

Direcione a intenção de hotel assistida por AI para fluxos de reserva controlados com Agentic AI e o servidor MCP.

Agências & DMCs

Construa vitrinas personalizadas, fluxos de reserva ou produtos de itinerário com Web Components.

Gestor de canais / PMS

Coordene disponibilidade, tarifas, reservas e fluxos de eventos relacionados.

Por que construir sobre ele

Um cartão de hotel é fácil. Um sistema de reservas hoteleiras não é.

Seção intitulada “Um cartão de hotel é fácil. Um sistema de reservas hoteleiras não é.”

O comércio hoteleiro necessita de regras de oferta, disponibilidade, tarifas, ofertas, políticas, checkout, pagamento, confirmação, atribuição e relatórios. Construa sobre essas camadas em vez de as reconstruir.

  • Reconstruir regras de oferta, tarifa e política
  • Ligar o checkout a dados específicos do hotel
  • Unir atribuição entre sessões
  • Gerir pagamentos, reembolsos e reconciliações
  • Controlar AI para que não invente disponibilidade
  • Manter tudo à medida que os hotéis mudam diariamente
  • Integre oferta aprovada pelo hotel a partir do Extranet
  • Booking Engine trata do checkout, pagamento e confirmação
  • Atribuição preservada por 6 meses por clique
  • Subscreva 64+ eventos webhook
  • Transferência AI estruturada via MCP + Agentic AI
  • 5,5% tudo incluído — Booking Engine em cada transferência

O modelo

Desde a primeira chamada até à reserva confirmada.

Seção intitulada “Desde a primeira chamada até à reserva confirmada.”

Um caminho de integração desde a conexão até ao cumprimento.

  1. 1

    Conectar

    Adicione o servidor MCP alojado ou solicite acesso à API com OAuth2 para começar com contratos ao vivo.

  2. 2

    Ler contratos ao vivo

    Pesquise operações e leia os esquemas atuais de pedido e resposta — sem adivinhações, sem documentação desatualizada.

  3. 3

    Construir o fluxo

    Ligue pesquisa, disponibilidade, reserva, pagamento e relatórios ao seu produto.

  4. 4

    Subscrever eventos

    Reaja a 64+ eventos webhook: estado da reserva, pagamentos, reembolsos, cancelamentos e alterações de canal.

  5. 5

    Cumprir no Booking Engine

    Cada chamada resolve-se no Booking Engine para checkout, pagamento e confirmação específicos do hotel.

Para agentes AI — comece aqui

Um servidor MCP alojado permite que um agente descubra as APIs do Wink e construa uma integração funcional sem adivinhar os endpoints.

Endpoint HTTP transmitido (fallback SSE em /sse). A partir do Claude Code:

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

Também funciona com Codex, Cursor e VS Code — veja a documentação MCP.

Duas ferramentas resolvem intenção para operações reais e documentação conceptual:

  • api_searchencontre a operação a chamar — ex. “consultar inventário”, “criar reserva”, “recibo de pagamento”
  • docs_searchencontre conceitos — “autenticação”, “webhooks”, “atribuição”

Cada resultado retorna um URI wink:// — abra a operação, o seu esquema de pedido/resposta, ou a sua receita de tarefa.

wink-api-builder usa o servidor MCP como fonte de verdade: api_search → contratos ao vivo → autenticação → código verificado, e assinala qualquer discrepância com a API atual.

Funciona com Claude Code, Codex e Cursor — veja AI Skills.

Crie a reserva via API e o Booking Engine cumpre-na — checkout, pagamento, confirmação e sincronização da reserva com o PMS ou gestor de canais conectado, com contexto de origem preservado.

Subscreva booking.created e outros 63 eventos para reagir em tempo real.

Um motor, todas as integrações

Todas as integrações convergem no Booking Engine.

Seção intitulada “Todas as integrações convergem no Booking Engine.”

Seja qual for a forma como o seu produto envia a procura — API, agente, componente ou link — a reserva resolve-se num único local que controla.

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

Booking Engine

checkout · payment · confirmation

Reserva confirmada

Pagamento efetuado, hóspede confirmado, atribuição e contexto de origem preservados.

A gama completa

Desde uma construção API completa até um componente drop-in.

Seção intitulada “Desde uma construção API completa até um componente drop-in.”

Vá tão fundo quanto uma integração REST + MCP completa — ou, quando isso for mais do que o trabalho necessita, incorpore um Web Component do Studio: cartões de hotéis, mapas, grelhas e módulos de reserva. De qualquer forma, o Booking Engine cumpre a reserva por baixo.

  • API REST + OAuth2 completa, servidor MCP alojado e SDKs
  • Ou Web Components reserváveis — cartões, mapas e grelhas
  • 64+ eventos webhook para reconciliação em tempo real
  • Cumprimento pelo Booking Engine por baixo de cada superfície
Veja a documentação Build on Wink
Um Web Component de cartão de hotel incorporável do Wink

Perguntas Frequentes para Desenvolvedores

O que equipas técnicas e de produto perguntam primeiro.

Existe uma página de produto separada para acesso à API?
Não. O acesso à API é gerido através da página Builders e da documentação Build on Wink, não através de uma página de produto de marketing independente.
O acesso à API substitui o Booking Engine?
Não. O acesso à API direciona a procura e a lógica de integração. O Booking Engine continua a ser a camada de cumprimento para checkout, pagamento, confirmação e conclusão de reservas específicas de hotéis.
Assistentes AI podem usar o Wink?
Sim. Um servidor MCP alojado permite que agentes AI leiam os contratos API em tempo real para que possam pesquisar oferta hoteleira ao vivo, criar reservas e efetuar pagamentos através do Booking Engine — completando uma reserva num único fluxo, não apenas redirecionando o utilizador para um website. Qualquer hotel está pronto para agentes assim que o seu perfil está ativo no Wink.
Posso incorporar cartões de hotéis ou mapas sem uma integração API completa?
Sim. O Studio pode criar Web Components como cartões de hotéis, mapas, grelhas e outros ativos incorporados quando uma solução mais simples é suficiente — o Booking Engine cumpre a reserva por baixo.
Grupos hoteleiros podem usar o acesso para desenvolvedores?
Sim. Grupos hoteleiros e operadores técnicos podem usar o acesso para desenvolvedores, quando aprovados, para conectar a oferta, reservas e fluxos de relatórios do Wink com sistemas internos.
Por onde devem começar os desenvolvedores?
Conectem-se ao servidor MCP, leiam a documentação Build on Wink e solicitem acesso à API quando o caso de uso do produto, o âmbito técnico e a via comercial estiverem claros.
O acesso para desenvolvedores está aberto a todos?
O acesso para desenvolvedores deve ser controlado. A documentação pública e o servidor MCP podem suportar a avaliação, mas as credenciais API e o uso em produção devem corresponder ao produto aprovado e ao contexto comercial.

Pronto para construir comércio hoteleiro no seu produto?

Seção intitulada “Pronto para construir comércio hoteleiro no seu produto?”

Conecte o servidor MCP, leia a documentação, escolha a superfície de integração certa e solicite acesso quando o seu produto estiver pronto para conectar procura hoteleira aprovada ao cumprimento pelo Booking Engine.