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

Nota

La vostra primera aplicació ja està creada quan creeveu un compte nou. Utilitzem aquesta aplicació per a alguns escenaris de reserva.

No podeu reutilitzar aquesta aplicació. Si us plau, creeu noves aplicacions segons les necessiteu.

Entrada d’aplicació d’exemple

Nota

Una aplicació generada a Wink es pot utilitzar per a tots els punts finals de l’API.

1. Seleccioneu el compte amb què voleu treballar des de Comptes.
2. Feu clic a Accions a la part inferior de la targeta del compte i trieu Gestionar compte.
3. Feu clic a la pestanya Aplicacions a la pàgina següent.
4. Aquesta secció mostrarà totes les vostres aplicacions.
5. Trieu editar una aplicació existent o crear-ne una de nova.

Crear aplicació

Com que no podeu accedir a la clau secreta de l’aplicació que vam crear per a vosaltres, haureu de crear la vostra pròpia.

Precaució

Heu de crear un compte d’afiliat a Wink o un compte a TripPay abans de crear una aplicació, ja que vincularreu la vostra aplicació a un compte específic.

Tipus de client

Quan creeu una aplicació, trieu un tipus de client que determina com s’autentica l’aplicació:

• SPA (Single Page Application) — Per a aplicacions frontend basades en navegador que utilitzen el flux d’autorització OAuth2 amb PKCE. Aquest és el tipus més comú per a aplicacions web.
• MACHINE_2_MACHINE — Per a integracions servidor a servidor que s’autentiquen directament amb credencials de client. Utilitzeu aquest tipus quan el vostre servei backend necessiti cridar les API de Wink sense que hi hagi un usuari present.

Aquí teniu els passos per crear una aplicació:

1. A la pàgina d’aplicacions, feu clic al botó Crear nova aplicació.
2. Nom Doneu un nom a la vostra aplicació. p. ex. Aplicació Genial
3. Tipus de client Trieu SPA per a aplicacions web o MACHINE_2_MACHINE per a integracions servidor.
4. Nom de l’entitat Vinculeu la vostra aplicació amb un dels vostres comptes existents. p. ex. Compte Genial
5. URIs de redirecció Es requereix almenys una URI de redirecció. S’utilitza per validar el domini de redirecció després d’una autenticació correcta. p. ex. https://www.sitigenial.com
6. URIs de redirecció post-tancament de sessió (Opcional) URLs on es pot redirigir els usuaris després de tancar la sessió. Això assegura que els usuaris aterrin en una pàgina coneguda després que la seva sessió acabi.
7. Feu clic al botó Desa per continuar.

Se us redirigeix de nou a la vostra llista d’aplicacions. Veureu la nova aplicació a la llista i tindreu accés a la clau secreta de l’aplicació només aquesta vegada. Assegureu-vos de copiar-la i guardar-la en un lloc segur.

Actualitzar aplicació

Haureu d’actualitzar la vostra aplicació si canvia alguna de les vostres URIs de redirecció o voleu afegir o eliminar una URI.

Per actualitzar una aplicació existent, feu el següent:

1. Feu clic a l’enllaç Accions de l’aplicació que voleu actualitzar.
2. Feu clic al botó Actualitzar sota Accions.
3. Feu els canvis a l’aplicació.
4. Feu clic al botó Desa per continuar.

Se us redirigeix de nou a la vostra llista d’aplicacions.

Eliminar aplicació

Precaució

Si us plau, no elimineu l’aplicació que vam crear automàticament per a vosaltres per assegurar que totes les funcions funcionin per al vostre compte.

Si no necessiteu més una aplicació, podeu eliminar-la.

Per eliminar una aplicació, feu el següent:

1. Feu clic a l’enllaç Accions de l’aplicació que voleu eliminar.
2. Feu clic al botó Eliminar sota Accions.
3. Feu clic al botó D'acord per confirmar l’eliminació.

Se us redirigeix de nou a la vostra llista d’aplicacions.