Saltar al contingut

Inici ràpid

Aquesta guia et porta de no res a una integració funcional en uns 30 minuts. Al final tindràs:

  • preus en viu d’hotels en una ciutat, des de la Partner API,
  • un enllaç de reserva que reconeix les reserves al teu compte,
  • una reserva de prova i un webhook que t’avisa que s’ha fet.

Tot passa en staging, el nostre entorn de proves. No cal que ens demanis accés, i passar a producció després tampoc necessita aprovació.

Vols…Comença aquí
Mostrar hotels a la teva app, web o producte d’IA i enviar viatgers a reservar, guanyant comissióAquesta guia
Reservar en nom dels teus clients com a agència de viatges autoritzadaAquesta guia fins al Pas 5, després Reservar com a agència de viatges
Integrar hotels reservables sense escriure una integracióWeb Components
Permetre que un agent d’IA cerqui i reserviMCP Servers i Agentic Payments
Connectar un channel manager o PMSAfegeix el teu Channel Manager

Utilitzes la Partner API per trobar hotels i els seus preus en viu. Cada hotel té un urlName estable. El converteixes en un enllaç a l’Enginy de Reserves de Wink, book.wink.travel, portant els teus IDs. El viatger reserva i paga allà, i la reserva es reconeix al teu compte.

Necessitaràs:

  • grpcurl, o Postman o Insomnia. La Partner API és gRPC, no REST.
  • curl.

Staging és completament separat de producció, amb els seus propis accessos i comptes.

  1. Ves a staging-app.wink.travel, clica Sign-In / Register i registra’t.

  2. Clica Accounts a la barra lateral esquerra, després Create, i tria I am an Affiliate. Les reserves que enviïs es reconeixeran a aquest compte. Mira Crear Compte.

L’aplicació dóna credencials al teu codi.

  1. A la targeta del teu compte, clica Actions > Manage account, després la pestanya Applications.

  2. Clica Create new application, posa-li un nom i tria Machine-to-machine com a tipus de client.

  3. A sota de scopes, selecciona Inventory & rates (lectura). La Partner API comprova inventory.read.

  4. Clica Create application i copia el Client ID i el Client secret. El secret es mostra una sola vegada i no es pot recuperar després.

Consulta Applications per als altres tipus de client i scopes.

Finestra del terminal
curl -X POST https://staging-iam.wink.travel/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=<YOUR_CLIENT_ID>" \
-d "client_secret=<YOUR_CLIENT_SECRET>" \
-d "scope=inventory.read"

Guarda el access_token de la resposta:

Finestra del terminal
export WINK_TOKEN=<access_token>

Els tokens caduquen. Al teu propi codi, deixa que una biblioteca OAuth2 els obtingui i refresqui. Mira Autenticació.

Si la sol·licitud del token és rebutjada, la resposta és un cos JSON amb un codi error:

errorEstat HTTPCausa habitual
invalid_client401Client ID o secret incorrecte, o credencials de producció usades a staging-iam
invalid_scope400La sol·licitud demana un scope per al qual l’aplicació no està registrada
unauthorized_client400L’aplicació no té permís per usar el grant client_credentials
invalid_request400Falta un paràmetre obligatori, per exemple quan el cos és JSON en lloc d’un formulari

Cada crida a la Partner API indica el compte per al qual actues en un header managing-entity-id. Llista els comptes per als quals el teu token pot actuar:

Finestra del terminal
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Copia el accountId del compte afiliat del Pas 1:

Finestra del terminal
export WINK_ACCOUNT_ID=<accountId>

Staging té hotels de prova amb disponibilitat a Bangkok, així que aquesta cerca usa el seu slug, bangkok-thailand:

Finestra del terminal
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-H "managing-entity-id: $WINK_ACCOUNT_ID" \
-d '{
"urlName": "bangkok-thailand",
"userSession": {
"itinerary": {
"startDate": "2026-12-01",
"nights": 2,
"room": { "adults": 2 }
},
"currencyCode": "USD",
"languageCode": "en"
}
}' \
staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCity

Utilitza una data d’entrada futura; una data passada és rebutjada. Cada resultat porta:

  • name, starRating i heroImageUrl, suficient per mostrar una fila de resultat,
  • roomTypes, les ofertes en viu, habitació més barata primer,
  • urlName, el slug que necessites per a l’enllaç de reserva.

Els preus són enters en unitats menors: divideix per 10 elevat a currencyExponent de la resposta (2 per USD, així 12500 és 125,00 $).

No saps el slug d’una ciutat? Resol-lo amb wink.partner.v1.Lookup/Search. Per al contingut complet d’una propietat, usa el servei Content. La referència de la Partner API documenta cada crida.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> és el urlName de l’hotel del Pas 5.
  • client-id és el Client ID de la teva aplicació del Pas 2.
  • configuration-id és el teu ID de personalització: Manage account > Customizations. Una personalització també estableix la teva marca, idioma i moneda per defecte a la pàgina de reserva.

Afegeix les dates, convidats, idioma i moneda del viatger al mateix enllaç perquè la pàgina de l’hotel s’obri amb aquests camps omplerts:

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD
ParàmetreSignificatExemple
sdData d’entradasd=2027-03-14
n o edNombre de nits, o data de sortidan=2 o ed=2027-03-16
rcConvidats per habitaciórc=a2 (2 adults)
lIdioma de visualitzaciól=en
cMoneda de visualitzacióc=USD
pCodi de promocióp=ABC123

Aquests paràmetres sobreescriuen els valors per defecte de la teva personalització. La guia del botó Reserva ara cobreix el format complet de rc, incloent nens i diverses habitacions.

L’enllaç obre la pàgina de l’hotel; no pot preseleccionar una habitació ni una tarifa. El viatger tria l’habitació a la pàgina de l’hotel, al preu en viu.

Consulta Enllaçar directament per enllaçar a la pàgina principal de l’enginy de reserves en lloc d’un hotel concret.

Obre el teu enllaç, tria dates i habitació, i paga amb una targeta de prova Stripe, per exemple 4242 4242 4242 4242 amb qualsevol data de caducitat futura i qualsevol CVC. No es cobra cap targeta real a staging. Apunta el codi de reserva a la pàgina de confirmació; comença per WNK.

  1. Al Portal, ves a Applications > Webhooks i afegeix un endpoint que accepti peticions POST.

  2. Subscriu-te a booking.create, o deixa la llista d’esdeveniments buida per rebre-ho tot mentre desenvolupes.

  3. Envia’t un esdeveniment de prova, després fes una altra reserva de prova i comprova que arriba.

Verifica la signatura de cada entrega abans de confiar-hi. Mira Integració Webhook i el Catàleg d’Esdeveniments Webhook.

No hi ha cap pas d’aprovació per a desenvolupadors. (Els comptes d’agència de viatges es certifiquen primer; mira més avall.) Quan la teva integració funcioni a staging:

  1. Crea un compte i una aplicació a app.wink.travel, com als Passos 1 i 2. Les credencials no es traslladen entre entorns.

  2. Elimina staging- de cada host:

    StagingProducció
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. Torna a buscar el teu ID de compte de producció (Pas 4) i l’ID de personalització (Pas 6). Són diferents dels de staging.

L’ús de la Partner API es mesura en nits d’hotel, amb una quota mensual gratuïta. Mira Partner API per preus i límits.

Si el teu compte és una agència de viatges autoritzada, no cal que enviïs viatgers a book.wink.travel: pots crear reserves directament amb wink.partner.v1.Booking/CreateBooking, i gestionar-les amb les altres crides Booking. Altres comptes envien els viatgers a l’enllaç de reserva.

Els comptes d’agència de viatges estan certificats: Wink revisa el registre de cada agència abans que pugui reservar. Les agències que volen cobrar directament als seus clients, com a comerciant registrat, han de reservar a través de la Partner API i obtenir l’aprovació escrita de Wink. Mira Començar com a agència de viatges i la referència de la Partner API.