Aplicacions
Les aplicacions us donen accés a totes les funcions de Wink com a desenvolupador. Podeu accedir a totes les dades i fins i tot ampliar les funcions pròpies de Wink. Podeu triar utilitzar el servidor OAuth2 de Wink per autenticar el vostre lloc de viatges de la mateixa manera que faríeu servir Google o Facebook. D’aquesta manera podeu ampliar les funcions de Wink al vostre propi lloc web o aplicació.
- Seleccioneu el compte amb què voleu treballar des de Comptes.
- Feu clic a
Accionsa la part inferior de la targeta del compte i trieuGestionar compte. - Feu clic a la pestanya
Aplicacionsa la pàgina següent. - Aquesta secció mostrarà totes les vostres aplicacions.
- Gireu o suprimiu una aplicació existent, o creeu-ne una de nova.
Crear aplicació
Section titled “Crear aplicació”Com que no podeu accedir a la clau secreta de l’aplicació que hem creat per a vosaltres, haureu de crear la vostra pròpia.
Podeu crear una aplicació aquí sense configurar primer una propietat o empresa — no està vinculada
a cap compte específic.
Tipus de client
Section titled “Tipus de client”Quan creeu una aplicació, trieu un tipus de client que determina com s’autentica l’aplicació. Això no es pot canviar després — si necessiteu un tipus diferent, creeu una aplicació nova.
- Aplicació web — Una aplicació renderitzada al servidor que pot mantenir de manera segura un secret de client (flux de codi d’autorització).
- Aplicació d’una sola pàgina (SPA) — Una aplicació de navegador sense backend; utilitza PKCE, sense secret de client.
- Aplicació mòbil — Una aplicació nativa iOS/Android; utilitza PKCE amb tokens de refresc rotatius.
- Màquina a màquina — Un servei backend que actua per si mateix (credencials de client); sense inici de sessió d’usuari.
Aquí teniu els passos per crear una aplicació:
- A la pàgina d’aplicacions, feu clic al botó
Crear aplicació nova. - Nom Doneu un nom a la vostra aplicació. p. ex. Aplicació Genial
- Tipus de client Trieu el tipus que coincideixi amb com s’autentica la vostra aplicació — vegeu Tipus de client més amunt.
- URI de redirecció Es requereix almenys una URI de redirecció. S’utilitza per validar el domini de redirecció després d’una autenticació correcta. No s’utilitza per a aplicacions màquina a màquina. p. ex. https://www.cool-site.com
- URI de redirecció després de tancar sessió (Opcional) URL on es pot redirigir els usuaris després de tancar sessió. Deixeu-ho en blanc per reutilitzar les URI de redirecció anteriors.
- Àmbits Trieu a què pot accedir aquesta aplicació en nom vostre — vegeu Triar àmbits més avall.
- Feu clic al botó
Crear aplicacióper continuar.
Se us redirigeix de nou a la llista d’aplicacions i apareix un diàleg únic amb el nou Client ID i secret de client. Copieu el secret ara i deseu-lo en un lloc segur — mai no es torna a mostrar, i no hi ha manera de recuperar-lo després (només podeu rotar per obtenir-ne un de nou).
Triar àmbits
Section titled “Triar àmbits”Cada aplicació sempre porta els àmbits Inici de sessió (OpenID Connect) (openid, profile,
email, offline_access) — aquests confirmen la identitat de l’usuari i el mantenen connectat, per això
es mostren marcats i bloquejats; no són una opció.
Tot el que queda és optatiu. Els àmbits restants s’agrupen en les mateixes seccions funcionals
documentades a Àmbits — Compte, Inventari i tarifes, Reserves,
Màrqueting i promocions, Contingut de la propietat, Anàlisis i informes, Integracions amb gestors de canals,
Pagaments i Comptabilitat i llibre major — cadascun amb una descripció en llenguatge clar del que desbloqueja. Utilitzeu
els enllaços Tots / Cap a sobre de la llista per seleccionar o desmarcar tots els àmbits opcionals alhora.
Hi ha dues famílies d’àmbits que deliberadament no s’ofereixen en aquest formulari:
mcp.*— Accés d’agents d’IA al transport del Model Context Protocol. No creeu una aplicació per a això: un client d’IA com Claude, ChatGPT o Codex es registra i sol·licita aquests àmbits quan inicieu sessió a través de la pantalla de consentiment MCP. Mai no s’atorguen a aplicacions màquina a màquina, perquè MCP sempre actua en nom d’un usuari connectat.- Àmbits de nivell administrador (
administrator.*) — accés a nivell de plataforma que no s’atorga per aplicació.
Un cop creada una aplicació, tant aquesta pestanya com Aplicacions consentides mostren els àmbits concedits agrupats per secció (p. ex. “Reserves: booking.read”), perquè pugueu veure què pot fer una aplicació d’un cop d’ull sense obrir-la.
Rotar credencials
Section titled “Rotar credencials”Si un secret de client pot haver estat filtrat, o simplement voleu credencials noves, roteu-les en lloc de recrear l’aplicació:
- Cerqueu l’aplicació a la vostra llista i feu clic a
Rotar. - Confirmeu el diàleg — el Client ID i secret actuals deixen de funcionar immediatament.
- Copieu el nou Client ID i secret del diàleg únic abans de tancar-lo.
La rotació manté el nom de l’aplicació, tipus de client, URI de redirecció i àmbits — només canvien les credencials.
Eliminar aplicació
Section titled “Eliminar aplicació”Si no necessiteu més una aplicació, podeu eliminar-la. Això és permanent — les credencials es revocaran immediatament i no es podran recuperar.
- Cerqueu l’aplicació a la vostra llista i feu clic a
Eliminar. - Confirmeu el diàleg per eliminar l’aplicació de manera permanent.
