
Het integreren van sloten in een app, PMS of gebouwplatform verloopt via twee verschillende toolsets: cloud-API's voor externe bewerkingen en Bluetooth SDK's voor bediening met een telefoon in de buurt. Ze door elkaar halen is de meest voorkomende fout bij het plannen van een integratie.
Wanneer een applicatie van een derde partij slimme sloten moet bedienen — een verhuurkanaal dat codes uitgeeft, een kantoorplatform dat bezoekers aanmeldt of een hotelapp die mobiele sleutels bezorgt — biedt de slotleverancier programmeerbare interfaces in twee lagen. De cloud-API is doorgaans een REST-achtige dienst via HTTPS: de applicatie authenticeert met OAuth-achtige inloggegevens, maakt toegangs- of ekeys, stuurt ontgrendelingsopdrachten op afstand voor online sloten, vraagt de slotstatus op en ontvangt webhookcallbacks voor ontgrendeling, een lage batterijspanning en manipulatie. De mobiele SDK is een bibliotheek die in de eigen iOS- of Android-app van de integrator is ingebed en die Bluetooth-detectie, beveiligde verbindingen, ontgrendeling in de buurt en offline logica voor inloggegevens afhandelt zonder een retourtrip naar een server. Succesvolle integraties gebruiken beide lagen bewust, beveiligen hun inloggegevens en testen snelheidslimieten en gebeurtenisaflevering vóór de lancering. Deze gids brengt de concepten en de relevante leveranciersvragen in kaart. API- en SDK-beschikbaarheid, bereiken en licenties voor elk platform worden per offerte schriftelijk bevestigd.
| Cloud-API | HTTPS-diensten beheren sloten, inloggegevens en gebeurtenissen vanaf een server; externe deuren zijn alleen bereikbaar wanneer de sloten online zijn via Wi-Fi of een gateway. |
| Mobiele SDK | In iOS/Android ingebedde bibliotheken regelen Bluetooth-verbindingen, ontgrendeling in de buurt en offline logica binnen de eigen app van de integrator. |
| Authenticatie | OAuth-achtige clientreferenties, tokens met een beperkt bereik en ondertekende webhooks onderscheiden professionele platforms van open relay-scripts. |
| Inloggegevens per API | Gangbare bewerkingen maken gedateerde codes, ekeys, kaarten en bezoekerslinks aan, met endpoints voor lijsten, updates en intrekking. |
| Gebeurtenisaflevering | Webhooks melden ontgrendeling, codegebruik, een lage batterijspanning en deurgebeurtenissen; het herhaalgedrag en de volgordegaranties moeten gedocumenteerd zijn. |
| Hardwareafhankelijkheid | Externe opdrachten worden alleen uitgevoerd op online sloten via Wi-Fi of een gateway, waardoor API-ontwerp en hardwaretopologie samen gepland moeten worden. |
| Ons beleid | Wij verstrekken interfacedocumentatie, een sandbox of testapparaten en een technisch contactpersoon; productie-inloggegevens en limieten komen uit de platformovereenkomst. |
Server-side automatisering (verhuurkanalen, PMS, bezoekersbeheer) is gebaseerd op de cloud-API; merkgebonden telefoonapps met bediening in de buurt of offline voegen de mobiele SDK toe. Producten die beide nodig hebben, moeten het model voor inloggegevens ontwerpen voordat er code wordt geschreven.
| Integratiedoel | Primaire toolset | Belangrijkste afhankelijkheid |
|---|---|---|
| Gedateerde verhuurcodes uitgeven | Cloud-API vanuit het boekingsbackend | De sloten ondersteunen het gewenste codetype en het synchronisatiepad. |
| Merkgebonden huurdersapp | Mobiele SDK plus cloud-API | Het appteam regelt de SDK-release en de beoordeling in de appstore. |
| Mobiele hotelsleutels bezorgen | Cloud-API-gebeurtenissen vanuit de PMS-middleware | Dekking van de inloggegevensdienst en gateways bij de deuren. |
| Kiosk voor bezoekersbeheer | Cloud-API voor eenmalige inloggegevens | Tijdzones en de semantiek van verval worden vroeg gevalideerd. |
| Live externe receptie | Ontgrendeling via de cloud-API plus webhookbevestiging | Alleen online sloten voeren externe opdrachten onmiddellijk uit. |
| Offline zakelijke wallet | Mobiele SDK met beveiligde lokale inloggegevens | Regels voor sleutelopslag en intrekking op het apparaat. |
API's komen bij het openen in botsing met de fysieke werkelijkheid: gateways, metalen deuren en batterijduur bepalen of een zuivere API-aanroep op tijd een slot bereikt. Test hardware en software samen.
| Opening | Typische deur | Slotbenadering |
|---|---|---|
| Deur van verhuureenheid | Bluetooth-slot met gateway per gebied | Het boekingsbackend maakt via de cloud-API offline en online codes aan. |
| Glazen kantooringang | Online lezer of controller | Het bezoekersplatform stuurt eenmalige inloggegevens en ontvangt webhooks voor toegang. |
| Hotelkamer | RFID-slot met dienst voor mobiele sleutels | De PMS-middleware roept de sleutel-API aan; de gateway stuurt live updates door. |
| Deur van coworkingruimte | Slim slot achter een glazen gevel | De ledenapp integreert de SDK voor ontgrendeling in de buurt, zelfs bij zwakke Wi-Fi. |
| Logistieke poort | Online buitenslot | Externe opdrachten vereisen bevestigde connectiviteit en fallbackcontacten. |
| Ruimte voor voorzieningen | Op afstand beheerd batterijslot | Webhooks voeren audits uit voor facturering en misbruikbeoordeling in de operator-app. |
API's lijken op slides op elkaar, maar verschillen in productie. Voordat engineeringtijd wordt vastgelegd, moeten integratoren de onderstaande punten verzamelen; wij helpen bij het coördineren hiervan met het platformteam.
| Component | Typische logica | Opmerkingen |
|---|---|---|
| API-referentie | Endpoints, bereiken, versies en sandboxbeschikbaarheid. | De schattingen van engineering zijn afhankelijk van volledige, actuele documentatie. |
| SDK-pakket | Ondersteunde OS-versies, voorbeeldapps en frequentie van releases. | Goedkeuring in de appstore en onderhoudmodellen moeten worden begrepen. |
| Beveiligingsmodel | Tokentypen, rotatie van secrets, webhookondertekening en IP-opties. | Het beveiligen van ontgrendelingsendpoints is niet-onderhandelbaar voor productie. |
| Limieten en quota | Snelheidslimieten, paginering, batchbewerkingen en herhaalregels. | Anders kunnen uitroltrajecten mislukken tijdens piekmomenten met veel incheckmomenten. |
| Gebeurteniscatalogus | Gebeurtenistypen, payloads, volgorde en leveringsgaranties bij herhaallevering. | Audit- en meldingsfuncties zijn afhankelijk van betrouwbare gebeurtenissen. |
Een API is een server-naar-serverinterface: uw backend communiceert via HTTPS met het slotplatform om codes aan te maken, ontgrendelingsopdrachten naar online slots te sturen, status op te vragen en webhookgebeurtenissen te ontvangen. Het werkt ongeacht de nabijheid van een telefoon. Een mobiele SDK is een softwarebibliotheek die in uw eigen iOS- of Android-app is ingebouwd en rechtstreeks via Bluetooth met slots communiceert. Zo kunt u sloten in de buurt ontgrendelen, ze instellen en offline toegangsgegevens opslaan wanneer er geen server bereikbaar is. Verhuurbackends en PMS-integraties hebben vooral de cloud-API nodig; merktenant-apps hebben doorgaans de SDK plus geselecteerde API-aanroepen nodig. Alles via de API proberen te doen — bijvoorbeeld een Bluetooth-only slot vanuit de andere kant van de wereld ontgrendelen zonder gateway — werkt simpelweg niet. De hardwaretopologie en interfacekeuze moeten daarom gezamenlijk worden ontworpen. De beschikbare interfaces per platform worden bij elke offerte schriftelijk bevestigd.
Ja, dat is een gangbaar integratiepatroon: zodra een reservering is bevestigd, roept uw backend of middleware de API van het slotplatform aan met de kamer of eenheid, de aankomst- en vertrekdatum, en ontvangt u een toegangscode of ekey die via uw eigen bericht- of e-mailsjabloon aan de gast wordt bezorgd. Webhooks bevestigen vervolgens het gebruik en markeren gebeurtenissen zoals vroege check-inpogingen of een bijna lege batterij. De zaken die u moet vastleggen, zijn onder meer de verwerking van tijdzones voor datumbereiken, welk codetype offline werkt op de gekozen slots, de gatewaydekking voor live intrekking, idempotente herhalingen bij het opnieuw verzenden van berichten en de wijze waarop annuleringen en datumwijzigingen de toegangsgegevens bijwerken. Wij leveren testslots en ondersteunen integratieworkshops; endpointdetails, snelheidslimieten en licenties voor elk platform worden bij elke offerte schriftelijk bevestigd.
Ontgrendeling op afstand is veilig wanneer het platform is opgebouwd als elke geauthenticeerde financiële API: OAuth-tokens met beperkte scopes, opslag van secrets aan de serverzijde, rechten per medewerker, opdrachtbevestiging via webhooks, auditlogs en optionele goedkeuring via tweestapsverificatie voor gevoelige deuren. Het wordt gevaarlijk wanneer integratoren langdurig geldende secrets in telefoonapps insluiten, open relay-endpoints blootstellen of ontgrendelings-URL's loggen. Fysieke beveiliging is eveneens belangrijk: afstandsopdrachten bereiken alleen online slots, en deuren met een hoog beveiligingsniveau schakelen ontgrendeling op afstand vaak volledig uit of vereisen dubbele goedkeuring. Vraag tijdens de due diligence om het securitywhitepaper, de procedure voor tokenrotatie en het webhookondertekeningssysteem in plaats van een claim dat er een “REST API beschikbaar” is. Wij coördineren deze beoordelingen met het platformteam en kunnen architecturen voorstellen waarbij ontgrendeling op afstand beperkt is tot receptierollen.
Webhooks zijn het standaard kanaal voor gebeurtenissen — ontgrendelingsrecords, codeinvoeringen, een bijna lege batterij, manipulationswaarschuwingen en wijzigingen bij deursensoren — maar de bezorgsemantiek verschilt per platform. Professionele platforms ondertekenen payloads, proberen mislukte bezorgingen opnieuw te verzenden met een steeds langere pauze en bieden een API om gemiste gebeurtenissen te reconciliëren of op te vragen. Dat is belangrijk omdat netwerken tijdelijk uitvallen en dubbele bezorging normaal is; consumenten moeten gebeurtenis-ID's daarom idempotent verwerken. Garanties over volgorde zijn zwakker: twee gebeurtenissen die enkele seconden na elkaar worden gegenereerd, kunnen soms omgekeerd binnenkomen. De auditlogica moet daarom de tijdstempel van de gebeurtenis bij het slot gebruiken, niet de aankomsttijd. Simuleer tijdens de pilot een offline ontvanger en controleer het gedrag bij herhaling. De gebeurteniscatalogus, het beleid voor opnieuw verzenden en de reconciliatie-endpoints van het bestelde platform worden vóór de ontwikkelingstart schriftelijk gedocumenteerd.
API-toegang wordt verleend door het slotplatform op basis van de eigen ontwikkelaars- en commerciële voorwaarden, doorgaans aan de accounteigenaar: het merk of de exploitant die het cloudproject bezit, en niet automatisch aan elke slotkoper. De fabrikant kan helpen de dienst te activeren, documentatie te leveren en de technische onboarding te coördineren, maar kan geen rechten toewijzen die verder gaan dan de platformovereenkomst. Sommige platforms maken onderscheid tussen gebruikers die alleen een app gebruiken, zakelijke accounts met dashboards en gecertificeerde ontwikkelaarspartners met volledige API-toegang. Een aantal geavanceerde endpoints vereist een goedgekeurde integratiebeoordeling. Kopers die diepe integraties plannen, moeten daarom vóór de hardwarekeuze de ontwikkelaarsgeschiktheid, kosten, gegevensverwerkingsvoorwaarden en ondersteunde regio's bevestigen, want een uitstekend slot zonder API-rechten kan het geplande product niet aansturen. De huidige ontwikkelaarsprogramma's en licenties per platform worden bij elke RFQ bevestigd.
Deel uw integratiegebruikssituaties, technologiestack en lanceringsplanning met uw RFQ. Wij coördineren API-documentatie, SDK-pakketten, testapparaten en platformovereenkomsten en ondersteunen een gezamenlijke pilot die offline gebruik, herhalingen en gebeurtenissen op schaal van een wagenpark behandelt.
Specificatieblad + offerte aanvragenTechnologieoverzichtLaatst bijgewerkt: 31 oktober 2026 · Beoordeeld door het redactionele team van Smart Lock Factory