Aplicații

Aplicațiile vă oferă acces la toate funcțiile Wink ca dezvoltator. Puteți accesa toate aceleași date și chiar extinde funcțiile Wink. Puteți alege să folosiți serverul OAuth2 Wink pentru a autentifica site-ul dvs. de călătorii în același mod în care ați folosi Google sau Facebook. Astfel, puteți extinde funcțiile Wink în propriul site web sau aplicație.

Exemplu de aplicație — *Exemplu de intrare în aplicație*

Selectați contul cu care doriți să lucrați din Conturi.
Faceți clic pe Acțiuni din partea de jos a cardului contului și alegeți Gestionați contul.
Faceți clic pe fila Aplicații de pe pagina următoare.
Această secțiune va lista toate aplicațiile dvs.
Rotiți sau ștergeți una existentă sau creați una nouă.

Creați aplicație

Deoarece nu puteți accesa cheia secretă a aplicației pe care am creat-o pentru dvs., va trebui să creați propria aplicație. Puteți crea o aplicație aici fără a configura mai întâi o proprietate sau o companie — nu este legată de niciun cont specific.

Tipuri de client

Când creați o aplicație, alegeți un tip de client care determină modul în care aplicația se autentifică. Acest lucru nu poate fi schimbat ulterior — dacă aveți nevoie de un tip diferit, creați o aplicație nouă.

Aplicație web — O aplicație redată pe server care poate păstra în siguranță un secret de client (flux cod de autorizare).
Aplicație single-page (SPA) — O aplicație în browser fără backend; folosește PKCE, fără secret de client.
Aplicație mobilă — O aplicație nativă iOS/Android; folosește PKCE cu tokenuri de reîmprospătare rotative.
Machine-to-machine — Un serviciu backend care acționează ca sine (credite client); fără autentificare utilizator.

Iată pașii pentru crearea unei aplicații:

Din pagina aplicațiilor, faceți clic pe butonul Creați aplicație nouă.
Nume Dați un nume aplicației dvs. ex. Aplicație Cool
Tip client Alegeți tipul care corespunde modului în care aplicația dvs. se autentifică — vedeți Tipuri de client mai sus.
URI-uri de redirecționare Este necesar cel puțin un URI de redirecționare. Este folosit pentru validarea domeniului de redirecționare după o autentificare reușită. Nu se folosește pentru aplicațiile Machine-to-machine. ex. https://www.cool-site.com
URI-uri de redirecționare după deconectare (Opțional) URL-uri unde utilizatorii pot fi redirecționați după deconectare. Lăsați gol pentru a reutiliza URI-urile de redirecționare de mai sus.
Domenii de acces (Scopes) Alegeți ce poate accesa această aplicație în numele dvs. — vedeți Alegerea domeniilor de acces mai jos.
Faceți clic pe butonul Creați aplicația pentru a continua.

Veți fi redirecționat înapoi la lista dvs. de aplicații, iar un dialog afișează o singură dată noul Client ID și secretul Clientului. Copiați secretul acum și păstrați-l în siguranță — nu va mai fi afișat niciodată, și nu există nicio modalitate de a-l recupera ulterior (doar rotiți pentru unul nou).

Alegerea domeniilor de acces (Scopes)

Fiecare aplicație poartă întotdeauna domeniile Autentificare (OpenID Connect) (openid, profile, email, offline_access) — acestea confirmă identitatea utilizatorului și îl mențin autentificat, așa că sunt bifate și blocate; nu sunt o opțiune.

Tot restul este opțional. Domeniile rămase sunt grupate în aceleași secțiuni funcționale documentate în Scopes — Cont, Inventar & tarife, Rezervări, Marketing & promoții, Conținut proprietate, Analize & rapoarte, Integrări channel manager, Plăți și Contabilitate & registru — fiecare cu o descriere în limbaj simplu a ceea ce deblochează. Folosiți linkurile Toate / Niciuna de deasupra listei pentru a selecta sau deselecta toate domeniile opționale odată.

Două familii de domenii nu sunt oferite intenționat în acest formular:

mcp.* — acces AI-agent la transportul Model Context Protocol, care este aprovizionat separat și doar pentru clienți machine-to-machine.
Domenii de nivel administrator (administrator.*) — acces la nivel de platformă care nu este acordat per aplicație.

Odată ce o aplicație este creată, atât această filă, cât și Aplicații cu consimțământ afișează domeniile acordate grupate pe secțiuni (ex. “Rezervări: booking.read”), astfel încât să puteți vedea ce poate face o aplicație dintr-o privire fără a o deschide.

Rotirea acreditărilor

Dacă un secret de client ar fi putut fi compromis sau doriți pur și simplu acreditări noi, rotiți-le în loc să recreați aplicația:

Găsiți aplicația în lista dvs. de aplicații și faceți clic pe Rotiți.
Confirmați dialogul — Client ID și secretul curent încetează să mai funcționeze imediat.
Copiați noul Client ID și secret din dialogul afișat o singură dată înainte de a-l închide.

Rotirea păstrează numele aplicației, tipul clientului, URI-urile de redirecționare și domeniile — doar acreditările se schimbă.

Ștergerea aplicației

Dacă nu mai aveți nevoie de o aplicație, o puteți șterge. Aceasta este o acțiune permanentă — acreditările sunt revocate imediat și nu pot fi recuperate.

Găsiți aplicația în lista dvs. de aplicații și faceți clic pe Ștergeți.
Confirmați dialogul pentru a șterge permanent aplicația.