Pāriet uz saturu

Lietojumprogrammas

Lietojumprogrammas 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 lietojumprogramma
Parauga lietojumprogrammas 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 Lietojumprogrammas.
  4. Šajā sadaļā tiks uzskaitītas visas jūsu lietojumprogrammas.
  5. Pagrieziet vai dzēsiet esošo, vai izveidojiet jaunu.

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

Izveidojot lietojumprogrammu, 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 lietojumprogrammu.

  • 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 — Dzimtā 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 pieslēgšanās.

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

  1. Lietotņu lapā noklikšķiniet uz pogas Izveidot jaunu lietojumprogrammu.
  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 šī lietojumprogramma var piekļūt jūsu vārdā — skatiet Piekļuves tiesību izvēli zemāk.
  7. Noklikšķiniet uz pogas Izveidot lietojumprogrammu, lai turpinātu.

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

Katra lietojumprogramma 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 viņu pierakstītu, 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 — 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 uzreiz.

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

  • mcp.* — AI aģenta piekļuve Model Context Protocol transportam. Jūs neveidojat lietojumprogrammu tam: AI klients, piemēram, Claude, ChatGPT vai Codex, reģistrējas pats un pieprasa šīs piekļuves tiesības, piesakoties caur MCP piekrišanas ekrānu. Tās nekad netiek piešķirtas mašīna-mašīnai lietotnēm, jo MCP vienmēr darbojas lietotāja vārdā, kurš ir pieslēdzies.
  • Administratora līmeņa piekļuves tiesības (administrator.*) — platformas līmeņa piekļuve, kas netiek piešķirta pa lietojumprogrammu.

Kad lietotne ir izveidota, gan šī cilne, gan Piekritušā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.

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ā lietojumprogrammu 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. Nokopējiet jauno Klienta ID un slepeno atslēgu no vienreizējā dialoga pirms tā aizvēršanas.

Pagriešana saglabā lietotnes nosaukumu, klienta tipu, pāradresācijas URI un piekļuves tiesības — mainās tikai akreditācijas dati.

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

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