Salta ai contenuti
Per gli sviluppatori

Costruisci il commercio alberghiero nel tuo prodotto.

Sezione intitolata “Costruisci il commercio alberghiero nel tuo prodotto.”

Commercio alberghiero API-first: ricerca, prenotazione, pagamento, 64+ webhook, attribuzione e passaggio AI — con un server MCP ospitato che permette agli agenti di leggere i contratti live, e Booking Engine che gestisce il fulfillment sottostante.

REST + OAuth2 + SDK Server MCP ospitato 64+ eventi 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

Cosa possono costruire gli sviluppatori con Wink?

Gli sviluppatori possono costruire flussi di lavoro di ricerca hotel, prenotazione, pagamento, webhook, attribuzione, reportistica, passaggio AI e commercio incorporato in prodotti approvati. L’accesso sviluppatore di Wink funziona con l’offerta controllata dall’hotel tramite Extranet, il contesto partner dalla rete sottostante, il passaggio AI tramite Agentic AI e il fulfillment con Booking Engine per checkout, pagamento, conferma e completamento della prenotazione specifici per l’hotel.

A chi è rivolto

Per team che costruiscono commercio alberghiero, non solo leggono documentazione.

Sezione intitolata “Per team che costruiscono commercio alberghiero, non solo leggono documentazione.”

L’accesso sviluppatore è adatto a team di prodotto, ingegneria, AI, piattaforma e operativi. Stai valutando un’integrazione per un prodotto AI, una banca o una super app? Vedi Per piattaforme e AI.

Team prodotto

Aggiungi commercio alberghiero a un'app o piattaforma esistente tramite accesso sviluppatore + Booking Engine.

Team prodotto AI

Indirizza l'intento alberghiero guidato dall'assistente in flussi di prenotazione controllati con Agentic AI e il server MCP.

Agenzie & DMC

Costruisci storefront personalizzati, flussi di prenotazione o prodotti itinerario con Web Components.

Channel manager / PMS

Coordina disponibilità, tariffe, prenotazioni e flussi di eventi correlati.

Perché costruirci sopra

Una scheda hotel è facile. Un sistema di prenotazione hotel non lo è.

Sezione intitolata “Una scheda hotel è facile. Un sistema di prenotazione hotel non lo è.”

Il commercio alberghiero richiede regole di offerta, disponibilità, tariffe, offerte, politiche, checkout, pagamento, conferma, attribuzione e reportistica. Costruisci su questi livelli invece di ricrearli da zero.

  • Ricostruire regole di offerta, tariffe e politiche
  • Collegare il checkout a dati specifici dell'hotel
  • Unire l'attribuzione tra sessioni
  • Gestire pagamenti, rimborsi e riconciliazioni
  • Limitare l'AI per evitare che inventi disponibilità
  • Manutenere tutto mentre gli hotel cambiano quotidianamente
  • Integra offerta approvata dall'hotel tramite Extranet
  • Booking Engine gestisce checkout, pagamento e conferma
  • Attribuzione preservata per 6 mesi per clic
  • Iscriviti a 64+ eventi webhook
  • Passaggio AI strutturato tramite MCP + Agentic AI
  • 5,5% tutto incluso — Booking Engine sotto ogni passaggio

Il modello

Dalla prima chiamata alla prenotazione confermata.

Sezione intitolata “Dalla prima chiamata alla prenotazione confermata.”

Un percorso di integrazione unico dalla connessione al fulfillment.

  1. 1

    Connetti

    Aggiungi il server MCP ospitato o richiedi accesso API con OAuth2 per iniziare con contratti live.

  2. 2

    Leggi i contratti live

    Cerca operazioni e leggi gli schemi di richiesta e risposta attuali — niente supposizioni, niente documentazione obsoleta.

  3. 3

    Costruisci il flusso

    Collega ricerca, disponibilità, prenotazione, pagamento e reportistica nel tuo prodotto.

  4. 4

    Iscriviti agli eventi

    Reagisci a 64+ eventi webhook: stato prenotazione, pagamenti, rimborsi, cancellazioni e cambi di canale.

  5. 5

    Fulfill con Booking Engine

    Ogni chiamata si risolve in Booking Engine per checkout, pagamento e conferma specifici per l'hotel.

Per agenti AI — inizia qui

Un server MCP ospitato permette a un agente di scoprire le API di Wink e costruire un’integrazione funzionante senza indovinare gli endpoint.

Endpoint HTTP streamabile (fallback SSE su /sse). Da Claude Code:

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

Funziona anche con Codex, Cursor e VS Code — vedi la documentazione MCP.

Due strumenti risolvono l’intento in operazioni reali e documenti concettuali:

  • api_searchtrova l’operazione da chiamare — es. “lookup inventory”, “create booking”, “payment receipt”
  • docs_searchtrova concetti — “authentication”, “webhooks”, “attribution”

Ogni risultato restituisce un URI wink:// — apri l’operazione, il suo schema richiesta/risposta, o la sua ricetta di task.

wink-api-builder usa il server MCP come fonte di verità: api_search → contratti live → auth → codice verificato, e segnala ogni discrepanza con l’API corrente.

Funziona con Claude Code, Codex e Cursor — vedi AI Skills.

Crea la prenotazione tramite API e Booking Engine la gestisce — checkout, pagamento, conferma e sincronizzazione con PMS o channel manager con contesto sorgente preservato.

Iscriviti a booking.created e altri 63 eventi per reagire in tempo reale.

Un motore, ogni integrazione

Qualunque sia il modo in cui il tuo prodotto invia la domanda — API, agente, componente o link — la prenotazione si risolve in un unico posto che controlli.

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

Booking Engine

checkout · payment · confirmation

Prenotazione confermata

Pagamento effettuato, ospite confermato, attribuzione e contesto sorgente preservati.

L’intera gamma

Da una build API completa a un componente drop-in.

Sezione intitolata “Da una build API completa a un componente drop-in.”

Vai in profondità con una completa integrazione REST + MCP — oppure, quando serve meno, usa un Web Component Studio: schede hotel, mappe, griglie e moduli di prenotazione. In ogni caso, Booking Engine gestisce il fulfillment sottostante.

  • API REST + OAuth2 completa, server MCP ospitato e SDK
  • Oppure Web Components prenotabili — schede, mappe e griglie
  • 64+ eventi webhook per riconciliazione in tempo reale
  • Fulfillment Booking Engine sotto ogni superficie
Vedi la documentazione Build on Wink
Un Web Component Wink per schede hotel incorporabili

FAQ per sviluppatori

Le domande tecniche e di prodotto più frequenti.

Esiste una pagina prodotto separata per l'accesso API?
No. L'accesso API è gestito tramite la pagina Builders e la documentazione Build on Wink, non tramite una pagina prodotto di marketing autonoma.
L'accesso API sostituisce Booking Engine?
No. L'accesso API gestisce la domanda e la logica di integrazione. Booking Engine rimane il livello di fulfillment per il checkout, pagamento, conferma e completamento della prenotazione specifici per l'hotel.
Gli assistenti AI possono usare Wink?
Sì. Un server MCP ospitato permette agli agenti AI di leggere i contratti API live per cercare l'offerta alberghiera in tempo reale, creare prenotazioni e prendere pagamenti tramite Booking Engine — completando una prenotazione in un unico flusso, non solo indirizzando l'utente a un sito web. Qualsiasi hotel è pronto per l'agente una volta che il suo profilo è live su Wink.
Posso incorporare schede hotel o mappe senza una piena integrazione API?
Sì. Studio può creare Web Components come schede hotel, mappe, griglie e altri asset incorporati quando una soluzione meno impegnativa è sufficiente — Booking Engine gestisce il fulfillment della prenotazione sottostante.
I gruppi alberghieri possono usare l'accesso sviluppatore?
Sì. I gruppi alberghieri e gli operatori tecnici possono usare l'accesso sviluppatore, previa approvazione, per collegare l'offerta, la prenotazione e i flussi di reportistica di Wink con i sistemi interni.
Da dove dovrebbero iniziare gli sviluppatori?
Connettersi al server MCP, leggere la documentazione Build on Wink, quindi richiedere l'accesso API quando il caso d'uso del prodotto, l'ambito tecnico e la modalità commerciale sono chiari.
L'accesso sviluppatore è aperto a tutti?
L'accesso sviluppatore dovrebbe essere controllato. La documentazione pubblica e il server MCP possono supportare la valutazione, ma le credenziali API e l'uso in produzione devono corrispondere al prodotto approvato e al contesto commerciale.

Pronto a costruire il commercio alberghiero nel tuo prodotto?

Sezione intitolata “Pronto a costruire il commercio alberghiero nel tuo prodotto?”

Connetti il server MCP, leggi la documentazione, scegli la superficie di integrazione giusta e richiedi l’accesso quando il tuo prodotto è pronto a collegare la domanda alberghiera approvata al fulfillment di Booking Engine.