De wereld van API's voelt soms als een doolhof. Spreek je het uit als Aapie of EE-PI-AIS? Wat is het verschil tussen REST, SOAP en API tokens? Zodra dit onderwerp op tafel komt vliegen de ingewikkelde termen je om de oren. Tijd voor opheldering. In dit blog lees je in begrijpbare taal hoe koppelen met Nmbrs werkt en welke opties er zijn. Lees snel verder.
De software van Nmbrs koppel je eenvoudig met andere applicaties. De techniek die het koppelen mogelijk maakt heet een API. Tot 2021 was er een specifieke API techniek beschikbaar. Namelijk: de SOAP API. Dit is een API die koppelpartners al jaren lang gebruiken voor integraties (koppelingen). Deze koppeling synchroniseert data tussen twee producten: de Nmbrs software en een ander software product.
De gesynchroniseerde data kan verschillende informatie bevatten. Van enkele medewerkers tot de gehele run-output. Veel van deze data wordt uiteindelijk gebruikt voor het bouwen van dashboards. Kortom, met de SOAP API bouw je vele koppelscenario’s met Nmbrs.
- Wist je dat: API staat voor: Application Programming Interface. Je spreekt de afkorting dan ook Engels uit.
Ook de wereld van API blijft zich doorontwikkelen. Als vervolg op de SOAP API techniek ontstond een nieuwe techniek: de REST API. In 2021 is Nmbrs gestart met het opzetten van deze koppeltechniek zodat je ook via deze API met Nmbrs integreert. Deze techniek brengt veel voordelen voor Nmbrs klanten met zich mee.
In het huidige integratielandschap zijn developers enthousiaster over werken met de REST API dan met de SOAP API. Ook zijn er andere verschillen die het voordeliger maken om met de REST API een koppeling te bouwen. Voor we in die voordelen duiken, leggen we graag het technische verschil aan je uit.
Voordeel voor Nmbrs klanten
Zet je de verschillen op de rij, dan zie je al snel het grote voordeel van koppelen met de REST API. De koppeling loopt een stuk soepeler dan zijn voorganger. Dit komt doordat de ontwikkelaar van de koppeling vooraf aangeeft welke toegang de integratie nodig heeft. Zo hoeft de Nmbrs gebruiker hier enkel toestemming voor te geven. Met de SOAP API moet dit handmatig aangezet worden in de login van de gebruiker. Hier zie je makkelijk gegevens over het hoofd die nodig zijn voor de koppeling.
Een ander groot voordeel van de REST API is de veiligheid. Gebruikers geven enkel toegang tot de data die de koppeling nodig heeft. Zo wordt er nooit toegang gegeven tot onnodige data van Nmbrs.
Het laatste voordeel dat de REST API voor gebruikers brengt is overzicht. In jouw Nmbrs omgeving zie je in één overzicht welke integraties zijn gekoppeld met je login. Zo zie je ook welke gegevens deze koppelingen ophalen uit of insturen naar Nmbrs.
Maakt het voor mij als gebruiker uit welke API er is gebruikt voor en koppeling?
Nee. Het maken van een koppeling kan met beide API's. De SOAP API heeft momenteel de meeste mogelijkheden voor het uitwisselen van data, maar uiteindelijk zal er net zoveel mogelijk zijn met de REST API. Het voordeel van beide mogelijkheden blijft hetzelfde: een mooie automatisering zodat je tijd bespaart.
Hoe weet ik welke API er wordt gebruikt?
Het verschil tussen SOAP en REST API herken je eenvoudig. Onderstaande legt uit hoe je de technieken van elkaar onderscheidt.
- SOAP API: Bij het inrichten van deze koppeling vul je een e-mailadres in samen met een token.
- REST API: Bij het starten van deze koppeling klik je op een knop. Deze brengt je naar een inlogpagina van Nmbrs. Na het inloggen kies je welke gegevens je wilt delen met de applicatie waarmee je de koppeling wilt leggen. Zo geef je toestemming voor de data-uitwisseling en gebruikt de integratie de REST API.
Kan de applicatie die ik gebruik en een actieve koppeling met Nmbrs heeft, overgaan naar een andere API?
Ja, dat kan. Op dit moment is de meerderheid van de koppelingen die je in de Nmbrs App Store vindt gebouwd met de SOAP API. Stap voor stap gaan onze integratie partners over naar de nieuwe manier via de REST API. Stapt een integratiepartner over REST API? Dan wordt je als gebruiker gevraagd om de integratie te accorderen door middel van het inloggen in Nmbrs en het geven van toestemming.
Na het lezen van dit artikel hopen we dat de verschillende koppeltechnieken wat minder abracadabra zijn. Momenteel zijn meer dan 150 koppelingen actief met Nmbrs. Wil je weten welke koppelingen dit zijn? Check dan de Nmbrs App Store.
