Creëer uw eigen integratie met onze handige SDK en Web API

Het Net2 toegangscontrole systeem is voorzien van een aantal krachtige en gebruikersvriendelijke integratie mogelijkheden. Hiermee stellen wij u als ontwikkelaar in staat om in alle vrijheid de applicatie of integratie te ontwikkelen voor uw klanten. Met de SDK is het mogelijk om een integratie te ontwikkelen met een bestaand software pakket zoals bijvoorbeeld betaalsystemen, personeelsdatabase of andere databasesystemen. Door gebruik te maken van de API is het voor u als ontwikkelaar mogelijk om snel en eenvoudig (web)applicaties te ontwikkelen of te integreren met een API van derden. Zowel de SDK als Web API die wij op deze pagina aanbieden zijn kosteloos te verkrijgen en ook zijn er geen betaalde licenties nodig.

Net2 Web Application Programming Interface (API)

De lokale REST Web API (Application Programming Interface) voor de Net2 software geeft integrators meer flexibiliteit voor het ontwikkelen van integraties met de Net2 software. U kunt gebruik maken van de meest voorkomende programmeertalen zoals C, C++, Java, Javascript en C#. Hierdoor bent u niet meer gebonden aan een Windows besturingssysteem om uw applicatie te ontwikkelen, u kunt nu ook uw applicatie ontwikkelen op MacOS en Linux.

De API is standaard beschikbaar in iedere Net2 software (v6.02 of hoger) en wordt geactiveerd door middel van de API licentie. Nadat u het integratie aanvraag formulier heeft ingevuld ontvangt u een bevestigingsmail met de API licentie en een link naar alle documentatie en de beschikbare methoden. De API maakt uitsluitend gebruik van een beveiligde HTTPS verbinding. Om de API te kunnen gebruiken dient u zelf een SSL certificaat te voorzien. Door een HTTPS verbinding te gebruiken zal alle communicatie tussen de integratie software en de Net2 API beveiligd worden.

In de API hebben wij al een groot aantal methoden geschreven voor u. De methoden zijn functies binnen het systeem die u kunt gebruiken, wij hebben de code al geschreven en u hoeft deze alleen te configureren. U hoeft dus niet meer vanaf nul te beginnen met het schrijven van uw applicatie of integratie. Bekijk Integratie mogelijkheden matrix om de beschikbare methoden in de API te bekijken. Wij hebben Swagger geïntegreerd zodat u gelijk de API documentatie kunt bekijken en de beschikbare methoden kunt gebruiken. Tevens maakt Swagger het mogelijk om uw geschreven code direct te testen op werking.

Voor support van de API gaat u naar het Software Development Forum

API SSL Certificaat

Een SSL certificaat wordt gebruikt om de verbinding tussen de Net2 API en integratie software die gekoppeld wordt te beveiligen zodat alle data van en naar het Net2 systeem beveiligd is. De API kan dan enkel via een beveiligde HTTPS verbinding gebruikt worden. Vanaf Net2 v6.7 SR1 is het niet meer mogelijk om de API te benaderen via de HTTP verbinding.

Vanaf Net2 v6.7 SR1 wordt het standaard Paxton SSL certificaat verwijderd en zal er een eigen SSL certificaat voorzien moeten worden om de API te kunnen gebruiken. Als integrator zal u dit SSL certificaat dienen aan te leveren en installeren om uw integratie te maken.

Welk type certificaat is er nodig.

Het is mogelijk om een eigen SSL certificaat te importeren en te gebruiken. SSL-certificaten kunnen rechtstreeks bij een certificeringsinstantie (CA) of certificaatuitgever worden aangevraagd. Deze certificaten worden gevalideerd door de certificeringsinstantie.

Daarnaast is het mogelijk om een eigen Self Signed Certificaat te gebruiken. U genereert bij deze optie zelf een SSL certificaat die u zelf ook signed. Dit is ideaal wanneer u een integratie heeft die alleen met interne systemen communiceert op het lokale netwerk. Dit certificaat wordt niet door een Certificaat instantie gecontroleerd. En betekent dat u een certificaat kan hebben met een lange geldigheidsduur van bijvoorbeeld 20 jaar. Dit is ideaal wanneer u niet de mogelijkheid heeft om uw certificaat jaarlijks te vervangen.  Er zijn verschillende manieren om een Eigen Self Signed Certificaat aan te maken. In een Self Signed Certificaat kunt u zelf diverse parameters bepalen.

De meest simpele manier is om het Net2 Paxton self signed SSL certificaat te gebruiken welke 365 dagen geldig is en jaarlijks vernieuwd dient te worden. Het nadeel is wel dat ieder jaar het certificaat vernieuwt dient te worden. Gebeurd dit niet dan zal de integratie niet meer functioneren als het certificaat verlopen is.