Deze gids laat zien hoe je toegang geeft aan een derde partij integratiepartner. Het proces laat jouw integratie toe om toegang te vragen via een eenvoudige URL. Dit is vooral nuttig wanneer een partner een installatie namens een gebruiker moet beheren. Zodra de toegang is verleend, kan de partner de installatie beheren in toekomstige integraties.
Wat je nodig hebt
- Vraag de derde partij aan wie je toegang geeft (zoals een CPO) om hun Lookup Key. Dit identificeert hun bedrijf of team in het Zapec-systeem.
- De Lookup Key is gekoppeld aan een UserGroup en kan worden gevonden onder het Details tabblad in elke UserGroup.
1. Bouw de Toegang Link
Gebruik dit formaat:
https://portal.zaptec.com/access/request/<lookup_key>
Vervang <lookup_key> met degene die je van de partner hebt gekregen.
Optioneel: Je kunt parameters toevoegen om de ervaring aan te passen, zoals taal of waar te redirecten na goedkeuring. Meer hierover hieronder.
2. Open de link en keur toegang goed
Zodra je de link hebt gebouwd, open je deze in je browser.
Je wordt gevraagd om:
- In te loggen met je Zaptec-account
- De toegang aanvraag te bekijken
- Deze goed te keuren of te weigeren
Nadat je goedkeurt, krijgt de derde partij (via hun UserGroup) toegang tot de installatie.
Wat ze kunnen doen
Zodra de toegang is verleend, kan de derde partij UserGroup:
De installatie- en oplaadgeschiedenis bekijken
Instellingen van de installatie wijzigen
Alle laders die aan de site zijn verbonden bedienen en configureren
⚠️ Toegang wordt verleend per installatie, niet per lader. Als de installatie meerdere laders heeft, zijn ze allemaal zichtbaar.
Pas de aanvraag aan met URL-parameters
Je kunt de link aanpassen met optionele parameters. Dit is wat er beschikbaar is:
| Parameter | Beschrijving |
|---|---|
| lookup | De lookup key van de UserGroup die toestemming aanvraagt. De groepsnaam wordt weergegeven na inloggen. |
| partnerName | De naam die wordt weergegeven voordat de gebruiker inlogt, die aangeeft wie toegang aanvraagt. |
| lang | Geeft de taal aan die voor het proces moet worden gebruikt. |
| installationId | Selecteert een specifieke installatie voor de toegang aanvraag. |
| installationtype | Staat 0 of 1 toe. Standaard zoekt het alleen naar Zaptec Go (1), maar kan ook op 0 worden ingesteld om naar Zaptec Pro te zoeken. |
| returnUrl: | Bepaalt waar de gebruiker na het proces naartoe wordt gestuurd. Als deze niet is opgegeven, wordt de ingebouwde ontvangstpagina van Zaptec gebruikt. |
| success | Geeft aan of de toegang is verleend (waar of onwaar). |
| showExisting | Stel in op "true" om alle installaties weer te geven waartoe de gebruiker toegang heeft, zelfs als de toegang al is verleend. Standaard is deze parameter "false". |
Voorbeeld link:
Hier is een voorbeeld van een correct geformatteerde toegang aanvraag URL: https://portal.zaptec.com/access/request/BSJG?partnerName=Integration&lang=en&returnUrl=https://yourapp.com/access-result&installationtype=1
In plaats van inloggegevens te delen of handmatige toegang te geven, stelt deze methode jou (de installateur of setup partner) in staat om de controle te hebben. Jij beslist wie toegang krijgt en wanneer.
Het is snel, veilig en werkt zonder heen en weer e-mails of administratieve overhead.
Je voegt geen gebruikers handmatig toe, je verleent toegang tot hun UserGroup. Iedereen in die groep krijgt toegang.
Je kunt later de toegang intrekken in het Zaptec Portal.
Als de installatie Zaptec Pro is, vergeet dan niet de installationid in de URL op te nemen.
Bijgewerkt