Pāriet uz saturu
Wink

Lietotnes

Lietotnes nodrošina piekļuvi visām Wink funkcijām kā izstrādātājam. Jūs varat piekļūt visiem tiem pašiem datiem un pat paplašināt Wink paša funkcijas. Jūs varat izvēlēties izmantot Wink OAuth2 serveri, lai autentificētu savu ceļojumu vietni tāpat kā Google vai Facebook. Tādā veidā varat paplašināt Wink funkcijas savā vietnē vai lietotnē.

Parauga lietotne
Parauga lietotnes ieraksts
  1. Izvēlieties kontu, ar kuru vēlaties strādāt, no Kontiem.
  2. Noklikšķiniet uz Darbības konta kartes apakšā un izvēlieties Pārvaldīt kontu.
  3. Nākamajā lapā noklikšķiniet uz cilnes Lietotnes.
  4. Šajā sadaļā tiks parādītas visas jūsu lietotnes.
  5. Pagrieziet vai dzēsiet esošo, vai izveidojiet jaunu.

Izveidot lietotni

Section titled “Izveidot lietotni”

Tā kā jums nav piekļuves lietotnes slepenajam atslēgai, ko mēs izveidojām jums, jums būs jāizveido sava. Jūs varat izveidot lietotni šeit, neiestatot īpašumu vai uzņēmumu — tā nav saistīta ar konkrētu kontu.

Klienta tipi

Section titled “Klienta tipi”

Izveidojot lietotni, jūs izvēlaties klienta tipu, kas nosaka, kā lietotne autentificējas. To vēlāk nevar mainīt — ja nepieciešams cits tips, izveidojiet jaunu lietotni.

  • Tīmekļa lietotne — Serverī renderēta lietotne, kas droši glabā klienta slepeno atslēgu (autorizācijas koda plūsma).
  • Vienas lapas lietotne (SPA) — Pārlūkprogrammas lietotne bez backend; izmanto PKCE, bez klienta slepenās atslēgas.
  • Mobilā lietotne — Dzimta iOS/Android lietotne; izmanto PKCE ar rotējošiem atsvaidzināšanas tokeniem.
  • Mašīna-mašīnai — Backend pakalpojums, kas darbojas pats par sevi (klienta akreditācijas dati); bez lietotāja pierakstīšanās.

Šeit ir soļi, kā izveidot lietotni:

  1. Lietotņu lapā noklikšķiniet uz pogas Izveidot jaunu lietotni.
  2. Nosaukums Piešķiriet savai lietotnei nosaukumu. piemēram, Cool App
  3. Klienta tips Izvēlieties tipu, kas atbilst tam, kā jūsu lietotne autentificējas — skatiet Klienta tipus augstāk.
  4. Pāradresācijas URI Nepieciešams vismaz viens pāradresācijas URI. Tas tiek izmantots, lai pārbaudītu pāradresācijas domēnu pēc veiksmīgas autentifikācijas. Netiek izmantots mašīna-mašīnai lietotnēm. piemēram, https://www.cool-site.com
  5. Pēc izrakstīšanās pāradresācijas URI (pēc izvēles) URL, uz kuriem lietotāji var tikt pāradresēti pēc izrakstīšanās. Atstājiet tukšu, lai atkārtoti izmantotu iepriekš minētos pāradresācijas URI.
  6. Piekļuves tiesības Izvēlieties, kam šī lietotne var piekļūt jūsu vārdā — skatiet Piekļuves tiesību izvēli zemāk.
  7. Noklikšķiniet uz pogas Izveidot lietotni, lai turpinātu.

Jūs tiksiet novirzīts atpakaļ uz savu lietotņu sarakstu, un vienreizējs dialogs parādīs jauno Klienta ID un slepeno atslēgu. Kopējiet slepeno atslēgu tagad un saglabājiet to drošā vietā — tā nekad vairs netiks rādīta, un to nav iespējams vēlāk atgūt (var tikai pagriezt uz jaunu).

Piekļuves tiesību izvēle

Section titled “Piekļuves tiesību izvēle”

Katra lietotne vienmēr satur Pierakstīšanās (OpenID Connect) piekļuves tiesības (openid, profile, email, offline_access) — tās apstiprina lietotāja identitāti un uztur pierakstīšanos, tāpēc tās ir atzīmētas un bloķētas; tās nav izvēle.

Viss pārējais ir pēc izvēles. Pārējās piekļuves tiesības ir grupētas tajās pašās funkcionālajās sadaļās, kas dokumentētas Piekļuves tiesībās — Konts, Inventārs un cenas, Rezervācijas, Mārketings un akcijas, Īpašuma saturs, Analītika un atskaites, Kanālu pārvaldnieka integrācijas, Maksājumi un Grāmatvedība un žurnāls — katrai ir vienkāršā valodā aprakstīts, ko tā atver. Izmantojiet saites Visas / Neviena virs saraksta, lai atlasītu vai notīrītu visas izvēles piekļuves tiesības vienlaikus.

Divas piekļuves tiesību grupas šajā formā apzināti netiek piedāvātas:

  • mcp.* — AI aģenta piekļuve Model Context Protocol transportam, kas tiek nodrošināts atsevišķi un tikai mašīna-mašīnai klientiem.
  • Administratora līmeņa piekļuves tiesības (administrator.*) — platformas līmeņa piekļuve, kas netiek piešķirta pa lietotnēm.

Kad lietotne ir izveidota, gan šī cilne, gan Atļautās lietotnes rāda tās piešķirtās piekļuves tiesības, grupētas pa sadaļām (piemēram, “Rezervācijas: booking.read”), lai jūs varētu uzreiz redzēt, ko lietotne var darīt, to neatverot.

Pagriezt akreditācijas datus

Section titled “Pagriezt akreditācijas datus”

Ja klienta slepenā atslēga varētu būt noplūdusi vai vienkārši vēlaties jaunas akreditācijas, pagrieziet tās, nevis izveidojiet lietotni no jauna:

  1. Atrodiet lietotni savā lietotņu sarakstā un noklikšķiniet uz Pagriezt.
  2. Apstipriniet dialogu — pašreizējais Klienta ID un slepenā atslēga nekavējoties pārstāj darboties.
  3. Kopējiet jauno Klienta ID un slepeno atslēgu no vienreizējā dialoga pirms tā aizvēršanas.

Pagriežot, saglabājas lietotnes nosaukums, klienta tips, pāradresācijas URI un piekļuves tiesības — mainās tikai akreditācijas dati.

Noņemt lietotni

Section titled “Noņemt lietotni”

Ja jums vairs nav vajadzības pēc lietotnes, varat to noņemt. Tas ir neatgriezeniski — akreditācijas dati tiek nekavējoties atsaukti un tos nav iespējams atgūt.

  1. Atrodiet lietotni savā lietotņu sarakstā un noklikšķiniet uz Dzēst.
  2. Apstipriniet dialogu, lai neatgriezeniski dzēstu lietotni.