Skip to content
Wink

Programėlės

Programėlės suteikia prieigą prie visų Wink funkcijų kaip kūrėjui. Galite pasiekti visus tuos pačius duomenis ir net išplėsti Wink funkcijas. Galite pasirinkti naudoti Wink OAuth2 serverį, kad autentifikuotumėte savo kelionių svetainę taip pat, kaip naudotumėte Google ar Facebook. Taip galite išplėsti Wink funkcijas savo svetainėje ar programėlėje.

Pavyzdinė programėlė
Pavyzdinis programėlės įrašas
  1. Pasirinkite paskyrą, su kuria norite dirbti, iš Paskyros.
  2. Spustelėkite Veiksmai paskyros kortelės apačioje ir pasirinkite Tvarkyti paskyrą.
  3. Kitame puslapyje spustelėkite skirtuką Programėlės.
  4. Šiame skyriuje bus išvardytos visos jūsų programėlės.
  5. Pasukite arba ištrinkite esamą, arba sukurkite naują.

Kurti programėlę

Section titled “Kurti programėlę”

Kadangi negalite pasiekti slaptą raktą programėlės, kurią sukūrėme jums, turėsite sukurti savo. Programėlę galite sukurti čia, nesukūrę iš anksto jokios nuosavybės ar įmonės — ji nėra susieta su konkrečia paskyra.

Klientų tipai

Section titled “Klientų tipai”

Kuriant programėlę, pasirenkate klientų tipą, kuris nulemia, kaip programėlė autentifikuojasi. Vėliau to pakeisti negalima — jei reikia kito tipo, sukurkite naują programėlę.

  • Tinklalapio programėlė — serverio atvaizduojama programėlė, kuri gali saugiai laikyti kliento slaptą raktą (autorizacijos kodo srautas).
  • Vieno puslapio programėlė (SPA) — naršyklės programėlė be backend; naudoja PKCE, be kliento slapto rakto.
  • Mobilioji programėlė — natyvioji iOS/Android programėlė; naudoja PKCE su besisukančiais atnaujinimo žetonais.
  • Mašina-mašinai — backend paslauga, veikianti kaip pati sau (kliento kredencialai); be vartotojo prisijungimo.

Štai žingsniai, kaip sukurti programėlę:

  1. Programėlių puslapyje spustelėkite mygtuką Sukurti naują programėlę.
  2. Pavadinimas Suteikite programėlei pavadinimą. pvz. Cool App
  3. Kliento tipas Pasirinkite tipą, atitinkantį, kaip jūsų programėlė autentifikuojasi — žr. Klientų tipai aukščiau.
  4. Peradresavimo URI Reikalingas bent vienas peradresavimo URI. Jis naudojamas patvirtinti peradresavimo domeną po sėkmingos autentifikacijos. Nenaudojamas mašina-mašinai programėlėms. pvz. https://www.cool-site.com
  5. Atsijungimo peradresavimo URI (Pasirinktinai) URL, į kuriuos vartotojai gali būti peradresuoti po atsijungimo. Palikite tuščią, jei norite naudoti aukščiau nurodytus peradresavimo URI.
  6. Sritis Pasirinkite, ką ši programėlė gali pasiekti jūsų vardu — žr. Srities pasirinkimas žemiau.
  7. Spustelėkite mygtuką Sukurti programėlę, kad tęstumėte.

Būsite peradresuoti atgal į savo programėlių sąrašą, o vienkartinis dialogas parodys naują Kliento ID ir Kliento slaptą raktą. Nukopijuokite slaptą raktą dabar ir saugokite jį saugioje vietoje — jis niekada nebus rodomas dar kartą, ir vėliau jo atkurti neįmanoma (galima tik pasukti ir gauti naują).

Srities pasirinkimas

Section titled “Srities pasirinkimas”

Kiekviena programėlė visada turi Prisijungimo (OpenID Connect) sritis (openid, profile, email, offline_access) — jos patvirtina vartotojo tapatybę ir palaiko prisijungimą, todėl jos yra pažymėtos ir užrakintos; jų pasirinkti negalima.

Visa kita yra pasirenkama. Likusios sritys suskirstytos į tas pačias funkcines sekcijas, aprašytas Sritys — Paskyra, Inventorius ir kainos, Užsakymai, Rinkodara ir akcijos, Nuosavybės turinys, Analitika ir ataskaitos, Kanalų valdymo integracijos, Mokėjimai ir Buhalterija bei apskaita — kiekviena su aiškiu aprašymu, ką ji atveria. Naudokite nuorodas Visos / Nėra virš sąrašo, kad vienu metu pasirinktumėte arba nuvalytumėte visas pasirenkamas sritis.

Dvi sričių grupės sąmoningai nėra siūlomos šiame formoje:

  • mcp.* — AI agento prieiga prie Model Context Protocol transporto, kuris yra suteikiamas atskirai ir tik mašina-mašinai klientams.
  • Administratorius lygio sritys (administrator.*) — platformos lygio prieiga, kuri nėra suteikiama pagal programėlę.

Sukūrus programėlę, tiek ši kortelė, tiek Sutikusios programėlės rodo suteiktas sritis pagal sekcijas (pvz. “Užsakymai: booking.read”), kad galėtumėte greitai matyti, ką programėlė gali daryti, neatidarant jos.

Pasukti kredencialus

Section titled “Pasukti kredencialus”

Jei kliento slaptasis raktas galėjo nutekėti arba tiesiog norite atnaujinti kredencialus, pasukite juos vietoje programėlės kūrimo iš naujo:

  1. Suraskite programėlę savo programėlių sąraše ir spustelėkite Pasukti.
  2. Patvirtinkite dialogą — esami Kliento ID ir slaptasis raktas iš karto nustoja veikti.
  3. Nukopijuokite naują Kliento ID ir slaptą raktą iš vienkartinio dialogo prieš jį uždarydami.

Pasukimas išlaiko programėlės pavadinimą, kliento tipą, peradresavimo URI ir sritis — keičiasi tik kredencialai.

Pašalinti programėlę

Section titled “Pašalinti programėlę”

Jei programėlė jums nebereikalinga, galite ją pašalinti. Tai yra galutinis veiksmas — kredencialai iš karto atšaukiami ir jų neįmanoma atkurti.

  1. Suraskite programėlę savo programėlių sąraše ir spustelėkite Ištrinti.
  2. Patvirtinkite dialogą, kad galutinai ištrintumėte programėlę.