Skip to content

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. Šioje skiltyje bus išvardytos visos jūsų programėlės.
  5. Pasukite arba ištrinkite esamą, arba sukurkite naują.

Kadangi negalite pasiekti slaptosios rakto programėlės, kurią sukūrėme jums, turėsite sukurti savo. Programėlę galite sukurti čia, nereikalaujant iš anksto nustatyti objekto ar įmonės — ji nėra susieta su konkrečia paskyra.

Kuriant programėlę, pasirenkate kliento 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ąjį raktą (autorizacijos kodo srautas).
  • Vieno puslapio programėlė (SPA) — naršyklės programėlė be backend; naudoja PKCE, be kliento slaptojo 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 (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. Kliento 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 po 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ąjį raktą. Nukopijuokite slaptąjį raktą dabar ir saugokite jį saugioje vietoje — jis niekada nebus rodomas dar kartą, ir vėliau jo atkurti neįmanoma (galima tik pasukti į naują).

Kiekviena programėlė visada turi Prisijungimo (OpenID Connect) sritis (openid, profile, email, offline_access) — jos patvirtina vartotojo tapatybę ir palaiko prisijungimą, todėl jos 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, Objekto turinys, Analitika ir ataskaitos, Kanalų valdymo integracijos, Mokėjimai ir 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 išvalytumėte visas pasirenkamas sritis.

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

  • mcp.* — AI agento prieiga prie Model Context Protocol transporto. Jums nereikia kurti programėlės tam: AI klientas, pvz., Claude, ChatGPT ar Codex, registruojasi pats ir prašo šių sričių prisijungimo metu per MCP sutikimo ekraną. Jos niekada nesuteikiamos mašina-mašinai programėlėms, nes MCP visada veikia prisijungusio vartotojo vardu.
  • Administratorius lygio sritys (administrator.*) — platformos lygio prieiga, kuri nėra suteikiama per programėlę.

Sukūrus programėlę, tiek ši skiltis, 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, jos neatidarinėdami.

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ąjį 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.

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

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