Aplicacions

Les aplicacions us donen accés a totes les funcions de Wink com a desenvolupador. Podeu accedir a totes les mateixes 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ó.

Aplicació d'exemple — *Entrada d’aplicació d’exemple*

Seleccioneu el compte amb què voleu treballar des de Comptes.
Feu clic a Accions a la part inferior de la targeta del compte i trieu Gestionar compte.
Feu clic a la pestanya Aplicacions a 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ó

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

Quan creeu una aplicació, trieu un tipus de client que determina com s’autentica l’aplicació. Això no es pot canviar més endavant — 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.
URIs 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
URIs de redirecció post-tancament de sessió (Opcional) URLs on es pot redirigir els usuaris després de tancar la sessió. Deixeu-ho en blanc per reutilitzar les URIs 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 vostra llista d’aplicacions, i apareix un diàleg únic que mostra el nou Client ID i el secret de client. Copieu el secret ara i deseu-lo en un lloc segur — mai no es mostrarà de nou, i no hi ha manera de recuperar-lo més tard (només podeu rotar per obtenir-ne un de nou).

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ó.

La resta és optativa. Els àmbits restants s’agrupen en les mateixes seccions funcionals documentades a Àmbits — Compte, Inventari i tarifes, Reserves, Màrqueting i promocions, Contingut de propietat, Analítiques i informes, Integracions de gestors de canals, Pagaments i Comptabilitat i llibre major — cadascuna 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, que es proveeix per separat i només per a clients màquina a màquina.
Àmbits de nivell administrador (administrator.*) — accés a nivell de plataforma que no es concedeix 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”), així podeu veure què pot fer una aplicació d’un cop d’ull sense obrir-la.

Rotar credencials

Si un secret de client pot haver estat filtrat, o simplement voleu credencials noves, rotar-les en lloc de recrear l’aplicació:

Cerqueu l’aplicació a la vostra llista d’aplicacions 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ó, el tipus de client, les URIs de redirecció i els àmbits — només canvien les credencials.

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 d’aplicacions i feu clic a Eliminar.
Confirmeu el diàleg per eliminar permanentment l’aplicació.