Applikationer

Applikationer ger dig som utvecklare tillgång till alla Wink-funktioner. Du kan komma åt samma data och till och med utöka Winks egna funktioner. Du kan välja att använda Winks OAuth2-server för att autentisera din resetjänst på samma sätt som du skulle använda Google eller Facebook. På så sätt kan du utöka Winks funktioner till din egen webbplats eller applikation.

Note

Din första app är redan skapad när du skapar ett nytt konto. Vi använder appen för vissa bokningsscenarier.

Du kan inte återanvända denna app. Skapa nya appar efter behov.

Exempel på applikationspost

Note

En applikation som genereras på Wink kan användas för alla API-endpoints.

1. Välj det konto du vill arbeta med från Accounts.
2. Klicka på Actions längst ner på kontokortet och välj Manage account.
3. Klicka på fliken Applications på följande sida.
4. Denna sektion listar alla dina applikationer.
5. Rotera eller ta bort en befintlig, eller skapa en ny.

Skapa app

Eftersom du inte kan komma åt secret key för appen vi skapade åt dig måste du skapa din egen. Du kan skapa en applikation här utan att först konfigurera en fastighet eller företag — den är inte bunden till något specifikt konto.

Klienttyper

När du skapar en applikation väljer du en klienttyp som avgör hur appen autentiserar. Detta kan inte ändras senare — om du behöver en annan typ, skapa en ny applikation.

• Webbapplikation — En server-renderad app som säkert kan behålla en klienthemlighet (auktoriseringskodflöde).
• Single-page app (SPA) — En webbläsarapp utan backend; använder PKCE, utan klienthemlighet.
• Mobilapp — En native iOS/Android-app; använder PKCE med roterande uppfräschnings-token.
• Maskin-till-maskin — En backend-tjänst som agerar som sig själv (klientuppgifter); ingen användarinloggning.

Här är stegen för att skapa en applikation:

1. På appsidan klickar du på knappen Create new application.
2. Namnge Ge din app ett namn. t.ex. Cool App
3. Klienttyp Välj den typ som matchar hur din app autentiserar — se Klienttyper ovan.
4. Redirect URIs Minst en redirect URI krävs. Den används för att validera redirect-domänen efter en lyckad autentisering. Används inte för maskin-till-maskin-appar. t.ex. https://www.cool-site.com
5. Post-logout redirect URIs (Valfritt) URL:er dit användare kan omdirigeras efter utloggning. Lämna tomt för att återanvända redirect URIs ovan.
6. Scopes Välj vad denna applikation kan komma åt å dina vägnar — se Välja scopes nedan.
7. Klicka på knappen Create application för att fortsätta.

Du omdirigeras tillbaka till din lista över applikationer, och en engångsdialog visar den nya Client ID och Client secret. Kopiera hemligheten nu och spara den på en säker plats — den visas aldrig igen, och det finns inget sätt att hämta den senare (bara rotera för en ny).

Välja scopes

Varje applikation har alltid Sign-in (OpenID Connect) scopes (openid, profile, email, offline_access) — dessa bekräftar användarens identitet och håller dem inloggade, så de visas som markerade och låsta; de är inte ett val.

Allt annat är frivilligt. De återstående scopes är grupperade i samma funktionella sektioner som dokumenteras i Scopes — Konto, Inventarie & priser, Bokningar, Marknadsföring & kampanjer, Fastighetsinnehåll, Analys & rapporter, Kanalhanterarintegrationer, Betalningar och Bokföring & huvudbok — var och en med en beskrivning på vardagsspråk av vad de låser upp. Använd länkarna All / None ovanför listan för att välja eller avmarkera alla valfria scopes på en gång.

Note

Betalningar och Bokföring & huvudbok är markerade som Känsliga eftersom de hanterar penningrörelser — bevilja dem endast till applikationer som specifikt behöver hantera betalningar eller huvudboken.

Två scope-familjer erbjuds medvetet inte i detta formulär:

• mcp.* — AI-agentåtkomst till Model Context Protocol transport, som tillhandahålls separat och endast för maskin-till-maskin-klienter.
• Administratörsnivå-scopes (administrator.*) — plattformsnivååtkomst som inte beviljas per applikation.

När en app är skapad visar både denna flik och Consented Apps dess beviljade scopes grupperade efter sektion (t.ex. “Bokningar: booking.read”), så att du kan se vad en app kan göra vid en snabb blick utan att öppna den.

Rotera autentiseringsuppgifter

Om en klienthemlighet kan ha läckt, eller om du bara vill ha nya autentiseringsuppgifter, rotera dem istället för att skapa om appen:

1. Hitta appen i din lista över applikationer och klicka på Rotate.
2. Bekräfta dialogen — den nuvarande Client ID och hemlighet slutar fungera omedelbart.
3. Kopiera den nya Client ID och hemligheten från engångsdialogen innan du stänger den.

Rotation behåller appens namn, klienttyp, redirect URIs och scopes — endast autentiseringsuppgifterna ändras.

Ta bort app

Caution

Vänligen ta inte bort appen vi automatiskt skapade åt dig för att säkerställa att alla funktioner fungerar för ditt konto.

Om du inte längre har användning för en app kan du ta bort den. Detta är permanent — autentiseringsuppgifterna återkallas omedelbart och kan inte återställas.

1. Hitta appen i din lista över applikationer och klicka på Delete.
2. Bekräfta dialogen för att permanent ta bort applikationen.