Forrit

Forrit gefa þér aðgang að öllum eiginleikum Wink sem verktaki. Þú getur nálgast öll sömu gögn og jafnvel bætt við eiginleikum Wink. Þú getur valið að nota OAuth2 þjóninn hjá Wink til að auðkenna ferðavefinn þinn á sama hátt og þú myndir nota Google eða Facebook. Á þennan hátt getur þú fellt eiginleika Wink inn í þinn eigin vef eða forrit.

Note

Fyrsta forritið þitt er þegar búið til þegar þú býrð til nýjan aðgang. Við notum þetta forrit í sumum bókunarsviðum.

Þú getur ekki endurnýtt þetta forrit. Vinsamlegast búðu til ný forrit eftir þörfum.

Dæmi um forritaskráningu

Note

Forrit sem búið er til á Wink má nota fyrir öll API-endapunkta.

1. Veldu þann aðgang sem þú vilt vinna með úr Accounts.
2. Smelltu á Actions neðst á aðgangskorti og veldu Manage account.
3. Smelltu á flipann Applications á næstu síðu.
4. Þessi hluti sýnir öll þín forrit.
5. Endurnýttu eða eyðileggðu núverandi forrit, eða búðu til nýtt.

Búa til forrit

Þar sem þú hefur ekki aðgang að leyndarmálslykli forritsins sem við bjuggum til fyrir þig, þarftu að búa til þitt eigið. Þú getur búið til forrit hér án þess að stofna fyrst eign eða fyrirtæki — það er ekki bundið við neinn sérstakan aðgang.

Tegundir viðskiptavina

Þegar þú býrð til forrit velur þú tegund viðskiptavinar sem ákvarðar hvernig forritið auðkennir sig. Þetta er ekki hægt að breyta síðar — ef þú þarft aðra tegund, búðu til nýtt forrit.

• Vefforrit — Forrit sem keyrir á netþjóni og getur örugglega geymt leynilykla (heimildarkóðaferli).
• Ein síðu forrit (SPA) — Vafraforrit án bakenda; notar PKCE, án leynilykils.
• Farsímaforrit — Innfædd iOS/Android forrit; notar PKCE með snúningi á endurnýjunarlyklum.
• Vél-til-vélar — Bakendþjónusta sem starfar sjálfstætt (viðskiptavinaskírteini); engin notendaauðkenning.

Hér eru skrefin til að búa til forrit:

1. Á forritasíðunni, smelltu á hnappinn Create new application.
2. Nafn Gefðu forritinu nafn. t.d. Cool App
3. Tegund viðskiptavinar Veldu tegund sem passar við hvernig forritið auðkennir sig — sjá Tegundir viðskiptavina hér að ofan.
4. Redirect URIs Að minnsta kosti ein redirect URI er nauðsynleg. Hún er notuð til að staðfesta redirect lénið eftir vel heppnaða auðkenningu. Ekki notuð fyrir vél-til-vélar forrit. t.d. https://www.cool-site.com
5. Post-logout redirect URIs (Valfrjálst) Vefslóðir þar sem notendur geta verið vísað eftir útskráningu. Láttu autt til að nota redirect URIs hér að ofan aftur.
6. Scopes Veldu hvað þetta forrit má nálgast fyrir þína hönd — sjá Velja scopes hér að neðan.
7. Smelltu á hnappinn Create application til að halda áfram.

Þú ert vísað aftur á lista yfir forrit þín og einu sinni birtist gluggi með nýja Client ID og Client secret. Afritaðu leyndarmálið núna og geymdu það á öruggum stað — það er aldrei sýnt aftur, og engin leið er að ná því aftur (aðeins að endurnýja það fyrir nýtt).

Velja scopes

Öll forrit bera alltaf með sér Innskráningu (OpenID Connect) scopes (openid, profile, email, offline_access) — þau staðfesta auðkenni notanda og halda honum innskráðum, svo þau eru merkt og læst; þau eru ekki val.

Allt annað er valfrjálst. Hin scopes eru flokkaðar í sömu virkniþætti sem eru skjalfestir í Scopes — Aðgangur, Birgðir & verð, Bókanir, Markaðssetning & kynningar, Eignainnihald, Greiningar & skýrslur, Samþættingar við rásarstjóra, Greiðslur, og Bókhald & reikningshald — hver með einfaldri lýsingu á því hvað það opnar. Notaðu tenglana All / None fyrir ofan listann til að velja eða hreinsa alla valfrjálsa scopes í einu.

Note

Greiðslur og Bókhald & reikningshald eru merkt Viðkvæm vegna þess að þau varða peninga- flutning — veittu þau aðeins forritum sem þurfa sérstaklega að hafa aðgang að greiðslum eða bókhaldi.

Tveir flokkar scopes eru meðvitað ekki í boði á þessu formi:

• mcp.* — Aðgangur gervigreindarfulltrúa að Model Context Protocol flutningi, sem er veittur sérstaklega og aðeins fyrir vél-til-vélar viðskiptavini.
• Stjórnanda-scopes (administrator.*) — aðgangur á vettvangsstigi sem er ekki veittur per forriti.

Þegar forrit er búið til sýna bæði þessi flipi og Samþykkt forrit veitt scopes flokkað eftir kafla (t.d. “Bókanir: booking.read”), svo þú sjáir hvað forrit getur gert með einum augnaopnum án þess að opna það.

Endurnýja auðkenni

Ef leyndarmálið gæti hafa lekið, eða þú vilt einfaldlega nýtt auðkenni, endurnýjaðu þau í staðinn fyrir að búa til forritið aftur:

1. Finndu forritið í lista yfir forrit og smelltu á Rotate.
2. Staðfestu gluggann — núverandi Client ID og leyndarmál hætta að virka strax.
3. Afritaðu nýja Client ID og leyndarmál úr einu sinni glugganum áður en þú lokar honum.

Endurnýjun heldur nafninu á forritinu, tegund viðskiptavinar, redirect URIs og scopes — aðeins auðkennin breytast.

Fjarlægja forrit

Caution

Vinsamlegast ekki eyða forritinu sem við bjuggum sjálfvirkt til fyrir þig til að tryggja að allir eiginleikar virki fyrir þinn aðgang.

Ef þú þarft ekki lengur forrit geturðu eytt því. Þetta er varanlegt — auðkennin eru afturkölluð strax og ekki hægt að endurheimta þau.

1. Finndu forritið í lista yfir forrit og smelltu á Delete.
2. Staðfestu gluggann til að eyða forritinu varanlega.