Vendion
    Kedjedrift

    API-nycklar i kedjeadmin

    4 min läsning
    Kategorier och artiklar

    Med Vendion API kan ett annat system, till exempel ert eventverktyg, läsa och skapa event i bordsbokningen. Systemet ansluter med en API-nyckel som ni skapar själva i Vendion. En nyckel är inte kopplad till en person och fortsätter fungera om den som skapade den slutar.

    Det här behöver du

    • Du är aktiv i kedjans Admin-grupp (Kedjeöversikt → Medlemmar). Avsnittet API-nycklar visas bara för Admin-gruppen.
    • Restaurangerna som systemet ska nå har Vendion Integration. En kedjenyckel når kedjans alla restauranger som har Vendion Integration, även restauranger som ansluts till kedjan senare.

    Skapa en API-klient

    En klient är systemet som ska anropa Vendion. Skapa en klient för varje system.

    1. Öppna Kedjeöversikt → Inställningar och gå ner till avsnittet API-nycklar.
    2. Tryck Skapa API-klient.
    3. Skriv systemets Namn, till exempel "Eventverktyget".
    4. Under Behörigheter väljer du vad systemet får göra. Alla fyra är ikryssade från början. Kryssa ur det systemet inte behöver.
    5. Tryck Skapa.
    BehörighetVad systemet får göra
    Läsa restaurangernaSe kedjans restauranger och vilka som har Vendion Integration.
    Läsa eventtyper och eventSe restaurangernas event och tillfällen, även dem ni lagt in direkt i Vendion.
    Skapa, ändra och ta bort eventLägga upp nya tillfällen av era event och ändra eller ta bort tillfällen. Ett tillfälle som har bokningar kan systemet varken ta bort eller flytta, och det kan inte sätta färre platser än det finns bokade gäster.
    Läsa summerade bokningssiffror (inga gästuppgifter)Se antal bokningar och gäster per dag och per event. Inga namn, telefonnummer eller e-postadresser.

    Vilka event systemet får lägga upp tillfällen av styr ni med en typkod på eventet, se Typkod på event.

    Skapa nyckeln

    1. Tryck Ny nyckel på klientens rad.
    2. Rutan Ny nyckel för [klienten] visar nyckeln. Tryck Kopiera nyckeln.
    3. Lägg in nyckeln i systemets inställningar, eller lämna den på ett säkert sätt till den som sätter upp systemet.
    4. Tryck Klar.

    Nyckeln visas bara den här gången. Vendion kan aldrig visa den igen. Har ni tappat bort den: skapa en ny nyckel och återkalla den gamla.

    Nyckeln ska bara ligga på en server, aldrig i en webbsida eller app. Läcker den: återkalla den direkt och skapa en ny.

    I listan står varje nyckel med sina första tecken, Skapad och Senast använd (Aldrig om den inte har använts än).

    Byta nyckel utan avbrott

    En klient kan ha flera nycklar samtidigt. Skapa en ny nyckel och låt systemet börja använda den. När den nya nyckelns Senast använd visar ett datum vet du att systemet använder den. Återkalla sedan den gamla.

    Återkalla en nyckel

    Tryck Återkalla vid nyckeln och bekräfta med Återkalla. System som använder nyckeln slutar fungera direkt. Nyckeln står kvar i listan med datumet den återkallades.

    Stäng av en klient

    Tryck Stäng av på klientens rad och bekräfta. Alla klientens nycklar återkallas och systemet slutar fungera direkt. Det går inte att ångra: behöver ni systemet igen skapar ni en ny klient. Klienten står kvar i listan, märkt Avstängd.

    En restaurangs egna nycklar

    En enskild restaurang kan också ha egna nycklar. De gäller bara den restaurangen.

    1. Öppna Integrationer i restaurangens admin.
    2. Tryck Hantera på kortet Vendion API.
    3. Skapa klient och nyckel på samma sätt som ovan.

    Du behöver behörigheten Hantera integrationer i restaurangen för att skapa och återkalla där.

    Kedjans klienter syns också i restaurangens lista, märkta Kedjans och med texten Kedjans klient: gäller alla restauranger i [kedjan]. Den hanteras av kedjan. Restaurangen kan se dem men inte återkalla eller stänga av dem. Det gör kedjans Admin-grupp i kedjans inställningar.

    Vendion Integration krävs

    API:t når bara restauranger som har modulen Vendion Integration. En restaurang utan den nås inte, varken med kedjans nycklar eller med egna, medan kedjans andra restauranger fungerar som vanligt. Kontakta Vendion för att aktivera Vendion Integration.

    Vad Vendion gör

    Vendion skapar aldrig nycklar åt er och kan inte se en nyckel i sin helhet. Vid support kan Vendion se era klienter och nycklar och återkalla en nyckel eller stänga av en klient, till exempel om en nyckel har läckt.

    Den här funktionen är en del av Vendion Kedjedrift.

    Nyfiken på hur det ser ut i praktiken? Läs mer om produkten eller boka en kort demo.

    Läs om Vendion KedjedriftBoka demo

    Var denna artikel hjälpsam?