Hoppa till huvudinnehåll

Integrationsguide för API och SDK

Generell introduktion och orientering för dig som utvecklare till Parakey ur ett integrationsperspektiv

Emil Janitzek avatar
Skrivet av Emil Janitzek
Uppdaterad denna vecka

Introduktion

Vad är Parakey?

Parakey är en digital nyckelplattform som gör det möjligt att öppna dörrar med mobilen istället för nycklar, kort eller taggar.

Integrationsmöjligheter

  • API – koppla Parakey till era befintliga system (HR, bokning, medlemssystem).

  • SDK för iOS & Android – bygg in Parakey och låsa upp direkt i er egen mobilapp.

  • Parakey-appen – färdig app för de som vill komma igång utan egen utveckling.

Vem riktar sig guiden till?

Guiden är framtagen för att kunna läsas av både tekniska och icke-tekniska roller.

  • Beslutsfattare och ansvariga kan få en överblick över hur Parakey fungerar.

  • Utvecklare hittar länkar vidare till den mer tekniska dokumentationen (API och SDK).


Användningsfall

Parakey används i många olika branscher och scenarier:

  • Företag - ge anställda access till kontor automatiskt via företagets egna system.

  • Fastighetsbolag - koppla Parakey till bokningssystem (t.ex. tvättstugor, förråd, garage).

  • Coworking & medlemskap - tilldela digitala nycklar direkt vid registrering.

  • Parkering - Utfärda access till låsta parkeringsgarage när kund hyr parkeringsplats.

💡 Resultatet: rätt person får rätt access vid rätt tid, helt automatiskt.


Kom igång

Checklista

Innan ni börjar integrera:

  1. Skaffa Parakey-konto (krävs för API och SDK).

  2. Hämta API-nycklar i Parakey Admin (alla integrationer använder API).

  3. Välj integrationssätt:

    1. API enbart – om ni vill koppla Parakey till befintliga system och låta användarna fortsätta använda Parakey-appen.

    2. API + SDK – om ni vill bygga in Parakey direkt i er egen app. SDK:erna använder API:t i bakgrunden.

  4. Testa i sandbox – börja i testmiljön innan ni går live.

👉 Detaljerade guider: Help Center – Integration via API.


API-integration

Vad är API:et?

Parakey API gör det möjligt att koppla ihop Parakey med era system. Vanliga användningsområden:

  • Skapa/uppdatera användare.

  • Tilldela eller ta bort nycklar.

  • Hämta loggar och händelser för analys.

👉 Full teknisk dokumentation: Parakey API
👉 Guider och exempel: Help Center – Integration via API


SDK-integration

Vad är SDK:erna?

SDK:erna gör det möjligt att bygga in Parakey direkt i era egna mobilappar. Slutanvändaren kan då öppna dörrar / lås utan att behöva ladda ner en separat app.

När passar SDK bäst?

  • Ni har redan en egen app (t.ex. personalapp, medlemsapp eller boendeapp).

  • Ni vill erbjuda en helhetsupplevelse i samma app som användaren redan använder.

  • Ni vill kontrollera designen och användarresan helt själva.


Arkitektur & flöden

Grundläggande begrepp

För att förstå hur integrationen fungerar är det bra att känna till de centrala byggstenarna i Parakey:

  • Plats – en byggnad eller anläggning som innehåller Lås, Användare och Nycklar.

  • Lås – det fysiska dörrlåset som styrs digitalt.

  • Användare – en person som kan få tillgång till en eller flera Platser och Lås via en Nyckel eller flera Nycklar.

  • Nyckel – kopplar ihop en Användare med ett eller flera Lås och Plats, och styr vilken access de har.

💡 En nyckel är alltså inte ett fysiskt objekt utan en tilldelning av access som styr vilken tillgång en användare har.

Flöde i praktiken

  1. Era system kommunicerar med Parakey Cloud via API.

  2. Parakey Cloud hanterar användare, nycklar och loggar.

  3. Mobilappar håller nycklarna och används för att öppna lås.

  4. Lås öppnas lokalt via Bluetooth.

Viktiga principer

  • Säkerhet: All access styrs centralt i Parakey Cloud och loggas.

  • Flexibilitet: Fungerar både med Parakeys egen app och med era egna appar via SDK.

  • Skalbarhet: Stödjer många dörrar, användare och integrationer samtidigt.

👉 För tekniska detaljer om autentisering, felhantering och kodexempel: se API-dokumentationen och SDK-guiderna.


Support & FAQ

Vanliga frågor

  1. Vad händer om mobilen är offline?
    Nycklar kan lagras i appen och användas offline, inom givna regler.

  2. Hur länge gäller en digital nyckel?
    Det styrs helt av era inställningar i Parakey (tillfälligt eller permanent).

Hjälp och resurser

Fick du svar på din fråga?