Partner API

La Wink Partner API è il modo autenticato e ad alto throughput per gli integratori di interrogare l’inventario di viaggi prenotabili — la stessa offerta che alimenta i nostri widget incorporabili e gli endpoint pubblici di navigazione, esposta come interfaccia programmatica di prima classe. Mentre i Web Components gratuiti e gli endpoint pubblici di navigazione sono pensati per un embedding leggero e rivolto all’utente finale, la Partner API è costruita per sistemi che cercano, valutano e prenotano su larga scala. L’accesso è autenticato per integratore e fatturato in base all’uso, quindi paghi solo per il traffico che effettivamente invii.

Piani e prezzi

L’utilizzo è misurato in hotel-notte: un hotel valutato per una notte di soggiorno — non una singola chiamata API. Una ricerca che restituisce 20 hotel per un soggiorno di 3 notti corrisponde a 60 hotel-notte da una singola richiesta. Le chiamate Content e Lookup (ricerca destinazioni e completamento automatico) sono un’eccezione: ciascuna costa un’unità per chiamata, qualunque sia il risultato. Gli endpoint account sono gratuiti. I Prezzi sono la fonte ufficiale per le tariffe.

	Free	Paid	Enterprise
Prezzo	0 $	Basato sull’uso	Contattaci
Ideale per	Valutazioni e integrazioni a basso volume	Throughput pay-as-you-go su larga scala	Volume personalizzato e condizioni negoziate
Unità al mese	10.000	Illimitate	Illimitate
Tempo di risposta API (P95)	—	Inferiore a 500 ms	Inferiore a 500 ms
Prezzo per unità (hotel-notte)	Gratuito	0,0001 $	Personalizzato
Risposta al limite mensile	429 fino al 1° del mese successivo (UTC)	Fatturato, non bloccato	Secondo accordo
Service Level Agreement	—	✓	✓
Supporto prioritario	—	✓	✓
Onboarding dedicato	—	—	✓

Ottieni una chiave API · Inizia la fatturazione a consumo · Contatta le vendite

Riferimento API

Due superfici servono l’inventario prenotabile, e corrispondono ai due livelli sopra:

• Free — Consumer / Booking Engine API (REST, /api/public/**): anonima, rivolta a browser e widget. Consulta il riferimento Booking Engine →
• Paid — Partner Integrator API (gRPC, wink.partner.v1): autenticata, a consumo, costruita per integrazione server-to-server su larga scala. Consulta il riferimento Integrator →

La Partner Integrator API è gRPC, non REST. La chiami con un client generato su HTTP/2 a partner.wink.travel:443, passando un token bearer e l’account per cui stai chiamando:

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

La pagina di riferimento sopra documenta ogni servizio, messaggio e stato di errore, e lo schema è anche disponibile a runtime tramite reflection del server, quindi grpcurl, Postman e Insomnia lo scoprono senza bisogno di scaricare nulla.

Se preferisci generare un client in anticipo, i file sorgente .proto sono pubblicati su github.com/wink-travel/partner-api-proto.

Come funzionano utilizzo e limiti

Livello Free

Il livello Free è progettato per permetterti di costruire, testare e gestire un traffico di produzione modesto senza costi.

• Nessun limite pubblicato per minuto. Wink monitora i tassi di richiesta e può applicare limiti di uso corretto per proteggere il servizio. Se ricevi un HTTP 429 (Too Many Requests), attendi il numero di secondi indicato nell’intestazione Retry-After prima di riprovare.
• Limite mensile — 10.000 unità per mese solare. Il limite è assegnato per account e si resetta il 1° di ogni mese (UTC). Una volta raggiunto, un account non iscritto alla fatturazione pay-as-you-go riceve HTTP 429 fino al 1° del mese successivo — un blocco rigido, con intestazione Retry-After e un messaggio che invita a sottoscrivere il livello Paid. Un account iscritto continua a funzionare e viene fatturato per l’uso oltre il limite.

Il livello Free non include un Service Level Agreement né supporto prioritario.

Livello Paid

Il livello Paid rimuove il tetto mensile e ti fattura solo per ciò che usi.

• Hotel-notte a consumo — 0,0001 $ per hotel-notte. Non c’è un tetto mensile; vieni fatturato sul volume effettivo. Wink può comunque applicare limiti di uso corretto per proteggere il servizio. Le chiamate di ricerca e inventario fatturano per hotel-notte valutato; le chiamate Content e Lookup fatturano un’unità ciascuna, quindi raggruppare le richieste aiuta a contenere la fattura.

Il livello Paid include il Service Level Agreement descritto di seguito — un impegno di uptime del 99,9% e un obiettivo di tempo di risposta P95 sotto i 500 ms — e supporto prioritario basato sulla gravità.

Service Level Agreement

Data di entrata in vigore: 5 luglio 2026 · Versione 1.0

Questo Service Level Agreement (il “SLA”) definisce l’impegno di disponibilità, i crediti di servizio e gli obiettivi di supporto che Wink (“Wink”, “noi”) fornisce a un cliente (“Cliente”, “tu”) per la Partner API autenticata di Wink (la “Partner API” o “Servizio”) nei livelli in cui è indicato che si applica un SLA. Questo SLA è incorporato e regolato dall’accordo tra te e Wink in base al quale accedi alla Partner API (l‘“Accordo”), e si applica finché mantieni un abbonamento attivo e a pagamento alla Partner API in regola. I termini con la lettera maiuscola non definiti qui hanno il significato loro attribuito nell’Accordo.

1. Definizioni

1. “Uptime” indica i periodi durante i quali la Partner API è disponibile ad accettare e rispondere con successo a richieste correttamente formate e autenticate.
2. “Downtime” indica qualsiasi periodo, misurato in minuti, durante il quale la Partner API non risponde con successo a richieste correttamente formate e autenticate, escludendo qualsiasi periodo rientrante nelle Esclusioni indicate nella Sezione 4. Errori isolati che interessano una frazione irrilevante di richieste non costituiscono, di per sé, Downtime.
3. “Percentuale di Uptime Mensile” indica, per un dato mese solare, il numero totale di minuti in quel mese meno i minuti totali di Downtime, diviso per il numero totale di minuti in quel mese, espresso in percentuale.
4. “Manutenzione Programmata” indica la manutenzione pianificata del Servizio per la quale Wink ha fornito un preavviso in conformità con la Sezione 4.
5. “Credito di Servizio” indica un credito, calcolato come percentuale delle tariffe pagate o dovute da te per la Partner API nel mese solare interessato, che viene applicato contro future tariffe della Partner API come unico e esclusivo rimedio per il mancato rispetto dell’impegno di Uptime.
6. “Tempo di Risposta” indica il tempo trascorso tra la ricezione da parte di Wink di una richiesta correttamente formata e autenticata al confine del servizio di Wink e il momento in cui Wink inizia a restituire la risposta, escludendo il transito di rete e qualsiasi tempo lato client fuori dal controllo di Wink.

2. Impegno di Disponibilità e Prestazioni

Wink farà sforzi commercialmente ragionevoli per rendere la Partner API disponibile con una Percentuale di Uptime Mensile di almeno il 99,9% durante ogni mese solare del periodo (l‘“Impegno di Uptime”). L’Impegno di Uptime è misurato al confine del servizio di Wink ed esclude qualsiasi fattore fuori dal ragionevole controllo di Wink, inclusi quelli descritti nella Sezione 4. I sistemi di monitoraggio di Wink sono la fonte autorevole per la misurazione della Percentuale di Uptime Mensile e del Tempo di Risposta.

Wink si impegna inoltre a un Tempo di Risposta al 95° percentile (P95) inferiore a 500 millisecondi per richieste correttamente formate, autenticate e andate a buon fine, misurato al confine del servizio di Wink su base mensile (l‘“Obiettivo di Prestazione”). L’Obiettivo di Prestazione esclude i fattori descritti nella Sezione 4, le richieste che restituiscono errori a livello applicativo causati dalla richiesta stessa e richieste batch insolitamente grandi o complesse. L’Obiettivo di Prestazione è un obiettivo di servizio; i Crediti di Servizio nella Sezione 3 si applicano ai mancati rispetto dell’Impegno di Uptime e sono l’unico e esclusivo rimedio per carenze di disponibilità.

3. Crediti di Servizio

Se la Percentuale di Uptime Mensile scende al di sotto dell’Impegno di Uptime in un qualsiasi mese solare, potresti avere diritto a un Credito di Servizio calcolato come percentuale delle tariffe della Partner API pagate o dovute da te per quel mese, secondo la seguente scala:

Percentuale di Uptime Mensile	Credito di Servizio
Inferiore al 99,9% ma pari o superiore al 99,0%	10%
Inferiore al 99,0% ma pari o superiore al 95,0%	25%
Inferiore al 95,0%	50%

1. Richiesta del credito. Per ricevere un Credito di Servizio devi inviare una richiesta scritta a Wink entro trenta (30) giorni dalla fine del mese solare in cui si è verificata la carenza. La richiesta deve includere le date e gli orari di ogni incidente di Downtime per cui richiedi il credito e qualsiasi log o prova ragionevolmente disponibile. Le richieste inviate dopo questo termine non sono ammissibili.
2. Forma del credito. I Crediti di Servizio approvati sono applicati contro future tariffe della Partner API e non hanno valore in denaro. Non sono rimborsi e non saranno pagati in contanti salvo quanto richiesto dalla legge applicabile.
3. Credito massimo. Il totale dei Crediti di Servizio assegnati per un singolo mese solare non supererà il 50% delle tariffe della Partner API pagate o dovute da te per quel mese.
4. Rimedio unico ed esclusivo. I Crediti di Servizio sono il tuo unico ed esclusivo rimedio per qualsiasi mancato rispetto da parte di Wink dell’Impegno di Uptime o qualsiasi altra carenza di disponibilità della Partner API.

4. Esclusioni

L’Impegno di Uptime e i relativi Crediti di Servizio non si applicano, e il Downtime non include, alcuna indisponibilità, sospensione, degrado o problema di prestazioni che derivi o sia correlato a:

1. Manutenzione Programmata per la quale Wink ha fornito un preavviso, purché tale preavviso sia stato dato con un ragionevole anticipo tramite un canale che Wink usa normalmente per comunicare con i clienti;
2. eventi di forza maggiore o altre cause fuori dal ragionevole controllo di Wink, inclusi disastri naturali, atti governativi, guasti di rete o di servizi pubblici, e attacchi denial-of-service o altri attacchi malevoli;
3. problemi causati da tue azioni od omissioni, dal tuo equipaggiamento, software o rete, o da qualsiasi servizio, prodotto o fornitore terzo non sotto il controllo diretto di Wink;
4. il tuo abuso del Servizio o violazione dell’Accordo, di questo SLA, dei termini di uso accettabile o dei limiti di traffico applicabili, inclusi traffico che Wink ritiene ragionevolmente eccessivo, abuso automatizzato o frode; e
5. qualsiasi sospensione o cessazione del tuo accesso effettuata correttamente ai sensi dell’Accordo, inclusa la sospensione per mancato pagamento.

5. Supporto e Obiettivi di Risposta

Wink fornisce supporto per la Partner API durante l’orario lavorativo standard, esclusi i giorni festivi locali. Wink farà sforzi commercialmente ragionevoli per riconoscere le richieste di supporto correttamente inviate entro i seguenti tempi di risposta target, basati sulla gravità che assegni e che Wink conferma ragionevolmente:

Gravità	Descrizione	Risposta iniziale target
Sev 1 — Critica	Partner API non disponibile o inutilizzabile in produzione senza soluzione alternativa.	4 ore
Sev 2 — Maggiore	Funzionalità significativa compromessa o degradata; esiste una soluzione alternativa.	1 giorno lavorativo
Sev 3 — Minore	Domande generali, problemi minori o richieste di funzionalità.	2 giorni lavorativi

I tempi di risposta target indicano quando Wink mira a stabilire il primo contatto; non sono garanzie di risoluzione. Il supporto prioritario e gli obiettivi basati sulla gravità si applicano ai livelli in cui sono indicati come inclusi.

6. Dati e Sicurezza

Wink mantiene misure amministrative, tecniche e organizzative commercialmente ragionevoli progettate per proteggere la riservatezza, integrità e disponibilità dei dati elaborati tramite la Partner API, e ne rivede periodicamente l’efficacia. Il trattamento dei dati personali da parte di Wink è regolato dalla Privacy Policy e da eventuali termini di trattamento dati nell’Accordo. Rimani responsabile della sicurezza delle tue credenziali API, dell’uso legale di qualsiasi dato recuperato e della tempestiva notifica a Wink di qualsiasi sospetto compromesso delle credenziali.

7. Limitazione di Responsabilità

I Crediti di Servizio sono l’unico ed esclusivo rimedio per qualsiasi indisponibilità o mancato rispetto dell’Impegno di Uptime, e sono forniti in luogo di qualsiasi altra responsabilità derivante da tale mancato rispetto. Salvo quanto espressamente previsto in questo SLA, la Partner API è fornita “così com’è”. Nella misura massima consentita dalla legge applicabile, la responsabilità complessiva di Wink derivante o correlata al Servizio è limitata come previsto nell’Accordo, e Wink non è responsabile per danni indiretti, incidentali, speciali, consequenziali o punitivi, né per profitti, ricavi, dati o avviamento persi, anche se avvisata della possibilità di tali danni.

8. Durata, Modifiche e Risoluzione

Questo SLA si applica finché hai un abbonamento attivo alla Partner API su un livello in cui è indicato che si applica l’SLA. Wink può aggiornare questo SLA di tanto in tanto; modifiche sostanziali saranno comunicate tramite un canale che Wink usa normalmente per raggiungere i clienti, e l’uso continuato della Partner API dopo l’entrata in vigore di un aggiornamento costituisce accettazione del SLA aggiornato. Questo SLA termina automaticamente alla risoluzione o scadenza dell’Accordo o del tuo abbonamento alla Partner API. Le sezioni che per loro natura devono sopravvivere alla risoluzione — inclusa l’idoneità ai Crediti di Servizio maturati ma non reclamati, la limitazione di responsabilità e le definizioni — sopravvivono.