Casestudy: één apparaat stuurt aanwezigheidsgegevens naar meerdere servers
De vereiste
Een klant beschikte over één biometrisch apparaat, maar moest de aanwezigheidsgegevens afleveren aan twee afzonderlijke softwaresystemen. Bijvoorbeeld een intern HR-platform en een externe payrollleverancier, zonder een tweede apparaat te installeren of de hardware tussen beide te verdelen.
Waarom het dual API-concept past
Normaal gesproken is één apparaat gekoppeld aan één API en één callback-URL: elke registratie wordt naar één bestemming gestuurd. Het dual API-concept doorbreekt deze een-op-een-beperking. In plaats van extra hardware toe te voegen, koopt de klant een extra API-licentie voor hetzelfde fysieke apparaat. Elke API krijgt een eigen callback-URL, en het apparaat stuurt elke aanwezigheidsregistratie tegelijkertijd naar alle ingestelde URL's, niet achter elkaar en niet met vertraging.
Dit betekent dat de klant geen twee apparaten bij de deur, geen twee inschrijfprocessen en geen twee sets hardwareonderhoud nodig had. Eén registratie, één apparaat, meerdere bestemmingen.
Hoe de stroom werkt
Dual API-stroom: één registratie wordt tegelijkertijd afgeleverd aan twee ingestelde callback-URL's
- De gebruiker registreert zich zoals gebruikelijk op het apparaat; er verandert niets aan de ervaring van de eindgebruiker.
- Het apparaat beschikt over twee (of meer) ingestelde API's, die elk naar hun eigen callback-URL verwijzen.
- De aanwezigheidsregistratie wordt tegelijkertijd naar elke ingestelde URL verstuurd.
- Elke ontvangende server/software verwerkt de registratie onafhankelijk; de ene is niet afhankelijk van de reactie van de andere.
Uitbreiden naar meer dan twee
Dit is niet beperkt tot twee bestemmingen. Hetzelfde concept geldt voor n API's op één apparaat; elke extra API is weer een shadow-API met een eigen callback-URL, en het apparaat stuurt naar al deze tegelijk. Een klant die aanwezigheidsgegevens synchroniseert naar HR, payroll en een compliance-dashboard, kan bijvoorbeeld drie API's op één apparaat instellen in plaats van drie afzonderlijke lezers te gebruiken.
Wat komt kijken bij de aankoop
|
Eerste API op het apparaat
|
Elke extra (shadow) API
Apparaatkosten zijn niet van toepassing; u gebruikt het bestaande apparaat opnieuw. |
Implementatieaantekeningen
- Elk API/callback-URL-paar werkt onafhankelijk; een storing of trage reactie op één callback-URL blokkeert of vertraagt de aflevering naar de andere niet.
- Omdat de aflevering gelijktijdig gebeurt en niet doordat de ene server de gegevens aan de volgende doorgeeft, is er geen afhankelijkheidsketen tussen de ontvangende systemen om te beheren.
- Dit werkt goed wanneer twee systemen dezelfde onbewerkte aanwezigheidsgegevens nodig hebben voor verschillende doeleinden (bijvoorbeeld payroll versus toegangslogging), in plaats van dat ze met elkaar moeten communiceren.
- Elke API en de bijbehorende callback-URL worden onafhankelijk ingesteld via het dashboard; het toevoegen van een shadow-API vereist geen herconfiguratie op het apparaat zelf.
- Gebruik API Monitor om de aflevering naar elke shadow-API afzonderlijk te controleren, omdat een afleverprobleem op de ene callback-URL niet noodzakelijkerwijs op een andere zichtbaar wordt.
- Omdat bestemmingen volledig ontkoppeld zijn, is dual API ook een handige manier om een migratie parallel uit te voeren: het bestaande systeem blijft gegevens ontvangen terwijl een nieuw systeem wordt getest, waarna u de oude callback-URL buiten gebruik stelt zodra u zeker bent van de overstap.
Resultaat
De klant voldeed aan de vereiste van twee bestemmingen met het bestaande enkele apparaat, waardoor de kosten en complexiteit van een tweede unit werden vermeden. Voor de opstelling werd alleen de aanvullende API-licentie voor de tweede bestemming aangeschaft, waarbij de apparaatkosten eenmalig werden gerekend.