Turnstile Gate SDK & API: Integratiegids voor ontwikkelaars en systeemintegratoren
2026-03-25
De draaipoortpoorten van Ironman ondersteunen volledige SDK- en API-integratie met softwaresystemen van derden — inclusief ticketingplatforms, HR-aanwezigheidssystemen, Bezoekersbeheertools, en gebouwbeheersystemen. Deze gids behandelt wat het draaipoort SDK API-pakket bevat, welke API-types worden ondersteund, en hoe je een live verbinding test met Postman. Als je ontwikkelaar of systeemintegrator bent die een leverancier van draaideuren evalueert, Dit is de technische referentie die je nodig hebt voordat je een beslissing neemt.
Voor cloud-connected implementaties, Zie onzeCloud-gebaseerde draaipoortsystemen — deze modellen bevatten standaard native API-ondersteuning.
SDK versus. API — Wat elk apparaat doet voor de integratie van draaipoorten
Een draaipoort SDK en API vervullen verschillende rollen in het integratieproces. Het begrijpen van het onderscheid bespaart opzettijd en voorkomt het meest voorkomende technische misverstand bij het starten van een nieuw project.
DeSDK is het complete ontwikkelingspakket. Het bevat documentatie, Codevoorbeelden, Bedradingspecificaties, Een interfacebord, en testhulpmiddelen. Je gebruikt de SDK tijdens de opzet- en bouwfase — voordat je software live gaat.
DeAPI is de commando-interface die je software oproept tijdens live werking. Elke keer dat een gebruiker een inloggegevens bij de poort presenteert, je platform stuurt een API-verzoek, en de draaihekcontroller reageert met een resultaat.
| SDK | API | |
|---|---|---|
| Wat het is | Volledig ontwikkelingspakket | Commando- en data-interface |
| Wie gebruikt het | Ontwikkelaar tijdens de installatie | Software tijdens live werking |
| Wat het bevat | Docs, Codevoorbeelden, Interfacebord, Testhulpmiddelen | Eindpunten, Parameters, Responsformaten |
| Wanneer je het nodig hebt | Integratie- en testfase | Elke poorttransactie na go-live |
Zie het zo.: de SDK is wat je gebruikt om de verbinding op te bouwen. De API is wat het daarna draait.
Wat het Turnstile Gate SDK-pakket van Ironman bevat
Wanneer je een SDK-pakket aanvraagt bij Ironman, Je ontvangt meer dan alleen een documentatiebestand. Het pakket dekt alles wat een ontwikkelaar nodig heeft om vanaf dag één een werkende integratie te voltooien.
Documentatie en specificatiebestanden
Het documentatiepakket bevat:
- Hardwareprotocolspecificatie: Definieert het communicatieformaat voor Wiegand 26-bit en 34-bit, RS485 serienummer, en droge contactrelaisuitgangen
- API-eindpuntreferentie: Volledige commandolijst, Parameterdefinities, en responscodebeschrijvingen
- Bedrading schema: Verbindingsindeling voor het API-interfacebord naar de controlepoort van de poort
- Ondersteunde credentialtypes: RFID, QR-code, biometrisch (Wiegan-uitgang vanaf terminal), en pin-invoer
Elk document wordt geleverd met de hardwarebestelling. Als je project aangepaste credentialmapping of niet-standaard protocollen vereist,, Het engineeringteam van Ironman beoordeelt de eisen voordat ze worden verzonden.
Softwaretools en voorbeeldcode
De softwarelaag van de SDK omvat:
- API-interfacebord: Een fysiek hardwarecomponent dat de draaipoortcontroller verbindt met je softwareomgeving (Lokale server, Cloud endpoint, of een pc op locatie)
- Codevoorbeelden: Aangeboden in gangbare talen op basis van je projectplatform — inclusief integratievoorbeelden voor HTTP POST-verzoekafhandeling
- Testhulpmiddelen: Gebruikt om het succes van API-aanroepen te verifiëren voordat je verbinding maakt met een productiesysteem
- Directe IT-ondersteuning: Het technische team van Ironman helpt bij de configuratie van de Postman-test en valideert de eerste 50 Actieve transacties tijdens ingebruikname
Uit onze ervaring met het implementeren van API-integraties voor locatie- en transitprojecten, Het interfacebord en de documentatie lossen samen op 90% van integratievragen voordat er een enkel supportticket nodig is.
API-typen ondersteund door Ironman Turnstile Gates
De draaipoortpoorten van Ironman ondersteunen drie primaire API-integratiepaden. De juiste hangt af van je softwarearchitectuur, Netwerkomgeving, en het type kwalificatie.
REST API (HTTP-gebaseerd)
REST API is het meest gebruikte integratiepad voor moderne softwareplatforms. Je applicatie stuurt HTTP POST- of GET-verzoeken naar het API-eindpunt van de draaipoort. De controller reageert met een JSON-payload — credential valid/invalid, Poort open/gesloten status, en een tijdstempel voor evenementen.
Dit pad past bij SaaS-ticketingplatforms, webgebaseerde HR-aanwezigheidssystemen, en cloudgehoste bezoekersbeheertools. Het vereist een netwerkverbinding tussen je server en het interfacebord van de draaipoort — ofwel LAN of internet, afhankelijk van het model.
SDK + Interfacebord (Hardware-naar-Software Brug)
Voor omgevingen zonder netwerkverbinding — inclusief offline faciliteiten, Beveiligingszones met luchtgaten, of legacy on-premise ERP-systemen — het interfacebord maakt direct verbinding met een lokale server of pc via RS485 of RS232.
De SDK levert de driver- en bibliotheekbestanden die je server nodig heeft om gatesignalen te lezen en toegangsbeslissingen terug te schrijven naar de controller. Dit traject is gebruikelijk in productiefaciliteiten en bedrijfscampussen die on-premise HR-systemen draaien.
Wiegand Protocol Softwarelaag
Wanneer inlogelezers Wiegand 26- of 34-bits signalen uitgeven, de SDK levert de parserbibliotheek die je software gebruikt om die signalen te interpreteren. Dit is vooral relevant voor HR-aanwezigheidssystemen waarbij RFID-kaartlezers al zijn aangesloten op de draaideurcontroller.
Wiegand is sinds de jaren zestig het industrieprotocol en blijft de meest gebruikte hardware-communicatiestandaard in bestaande toegangscontrolesystemen.
Stapsgewijze API-integratie workflow
Het voltooien van een draaipoort SDK API-integratie volgt een duidelijk proces van zes stappen.. De meeste projecten worden binnen 48–72 uur na ontvangst van het SDK-pakket live gegaan, mits het doelplatform van de software een actieve API heeft.
Stappen 1–3: Opstelling en verbinding
Stap 1 — Vraag je SDK-pakket aan: Neem contact op met Ironman met uw projectspecificaties — het gate-model, Soort kredenatie (QR-code, RFID-kaart, Biometrische terminal), en uw doelplatform voor software. Het engineeringteam bevestigt de compatibiliteit en verzendt het pakket.
Stap 2 — Het SDK-pakket ontvangen: Je ontvangt het API-interfacebord per post en de documentatiebestanden per e-mail. Bekijk de API-endpointreferentie en het bedradingschema voordat je de gatekast opent.
Stap 3 — Verbind de interfacekaart: Verbind de interfacekaart met de besturingspoort van de draaipoort via het bedradingschema. Zet het systeem aan en bevestig dat de LED-statusindicatoren op het bord een actieve verbinding tonen.
Stappen 4–6: Testen en Go-Live
Stap 4 — Configureer het API-eindpunt: Stel je software in om HTTP-verzoeken naar het lokale IP-adres van het interfacebord te sturen (voor LAN-installaties) of cloud-eindpunt (voor cloud-verbonden modellen).
Stap 5 — Test met postbode: Laad het API-referentiedocument in Postman. Bouw bijvoorbeeld een test-POST-verzoek met een voorbeeldpayload van de credential — bijvoorbeeld, een QR-codestring die je ticketsysteem genereert. Stuur het verzoek en bevestig dat de poort reageert met het verwachte JSON-resultaat. Het IT-team van Ironman kan je Postman-setup beoordelen en testresultaten direct valideren indien nodig.
Stap 6 — Verbind met je productiesysteem: Zodra Postman-tests slagen, Stuur je live software naar hetzelfde eindpunt. Houd de eerste in de gaten 50 Echte transacties voordat de testomgeving wordt verwijderd. Na bevestiging, De integratie is productieklaar.
Veelvoorkomende gebruikssituaties en compatibele softwaresystemen
De draaipoort SDK API ondersteunt een breed scala aan softwareplatforms in verschillende sectoren. Dit zijn de vier meest voorkomende inzetscenario's die het engineeringteam van Ironman behandelt.
- Ticketverkoop en locatiebeheer: Een QR-code op de telefoon of het geprinte ticket van de gebruiker wordt bij de gate gescand. De API stuurt de QR-string naar het ticketingplatform, die een geldige/ongeldige reactie teruggeeft. De poort opent alleen bij een geldig antwoord. Gebruik in stadions, Concertzalen, Tentoonstellingshallen, en pretparken.
- HR-aanwezigheid en tijdregistratie: Een RFID-kaart of vingerafdrukscan activeert een API-oproep naar het HR-systeem. Het systeem registreert de invoertijd, werknemers-ID, en gate lane. Gebruikt in productiebedrijven, Logistieke centra, en hoofdkantoren.
- Bezoekersbeheersystemen (VMS): Een vooraf geregistreerde bezoeker ontvangt een eenmalige QR-code per e-mail. Wanneer gescand bij de poort, de API valideert de code tegen de VMS en waarschuwt de host. Geen receptie nodig.
- Gebouwbeheersystemen (BMS): De gate is via RS485 verbonden met de BMS-controller. Poortstatus, Aantal passages, en alarmgebeurtenissen worden in realtime in het dashboard van het gebouw gevoed.
Voor enterprise-platforms zoals Lenel, Genetec, Brivo, of Honeywell Pro-Watch, bevestig het API-pad (REST of RS485 SDK) met het Ironman-team voordat hij specificeert — compatibiliteit verschilt per platformversie.
VoorVolledige hoogte beveiligingsdraaideuren inzetten in overheids- of hoogbeveiligde faciliteiten, dezelfde SDK geldt — de integratielaag verandert niet op basis van de gate-vormfactor.
Hardwareprotocolreferentie voor ontwikkelaars
Het kiezen van het juiste hardwareprotocol is de eerste beslissing in elk integratieproject. Deze tabel toont de primaire protocollen die Ironman-draaihekpoorten ondersteunen, hun technische grenzen, en de beste gebruikssituatie voor elk.
| Protocol | Type | Verspreiding | Apparaten per lijn | Beste gebruikssituatie |
|---|---|---|---|---|
| Wiegand 26/34-bit | Hardware | ≤150m | 1 per controllerpoort | RFID-lezer → controller |
| RS485 | Serienummer | ≤1.200 m | Tot 32 | Paneel-tot-poort, BMS-integratie |
| RS232 | Serienummer | ≤13m | 1 per haven | Debugging, Firmware-update |
| Droog contact (VFC) | Hardware | Korte afstand | N.v.t. | Eenvoudige open/sluit relais |
| REST API (HTTP) | Software | LAN/Internet | Onbeperkt | Cloud ticketing, HR, VMS |
| OSDP V2 | Hardware | ≤1.200 m | Meerdere | Hoogbeveiligde, AES-128 versleuteld |
Voor pure software-integraties: REST API is het juiste pad. Voor hardware-naar-software brugen in netwerkomgevingen: RS485 met de SDK-interfacekaart is standaard. OSDP V2 wordt aanbevolen voor implementaties die AES-128 versleutelde lezercommunicatie vereisen — vooral relevant voor de overheid, gezondheidszorg, en datacentertoegangspunten.
Voor projecten die worden ingezetslimme snelheidspoortpoorten bij invoeren met hoge doorvoer, REST API via LAN is de voorkeursintegratieweg — het verwerkt aanhoudende transactiesnelheden van 40–60 personen per minuut per baan zonder wachtrijvertragingen.
Veelgestelde vragen
Q1: Wat is het verschil tussen een turnstile gate SDK en API?
De SDK is het complete ontwikkelpakket dat je gebruikt om de integratie te bouwen — het bevat documentatie, Codevoorbeelden, een API-interfacebord, en testhulpmiddelen. De API is de commando-interface die je software oproept tijdens live werking. Je hebt de SDK nodig om de verbinding op te zetten. Je gebruikt de API elke keer dat de poort een credential verwerkt na go-live gaan.
Q2: Ondersteunt de Ironman draaipoortpoort SDK QR-code en biometrische integratie??
Ja. De SDK ondersteunt QR-codevalidatie via de REST API (je ticketing- of VMS-platform levert de QR-respons), RFID-kaartlezing via Wiegand 26/34-bit, en biometrische terminals die een Wiegan-signaal uitzenden. Voor gezichtsherkenningsterminals met eigen protocollen, Het engineeringteam van Ironman beoordeelt de compatibiliteit voordat het SDK-pakket wordt bevestigd.
V3: Is de draaipoortpoort SDK gratis of kost het extra?
De SDK-documentatie en API-referentie worden zonder extra kosten geleverd bij bevestigde gate-orders. Het API-interfacebord is een fysiek hardwarecomponent dat bij de gate wordt geleverd. Neem contact op met het Ironman-verkoopteam om te bevestigen of SDK is opgenomen voor jouw specifieke bestelling en projectomvang.
Q4: Hoe lang duurt het om een draaipoort-API-integratie te voltooien?
De meeste integraties zijn binnen 48–72 uur na ontvangst van het SDK-pakket go-live, mits het doelplatform van software een actieve API en een ontwikkelaar beschikbaar heeft voor testen. Meer complexe multi-gate of ERP-integraties kunnen 5–10 werkdagen duren. Het IT-team van Ironman biedt directe ondersteuning tijdens de testfase, wat het heen en weer aanzienlijk vermindert.
V5: Kan ik een draaipoort integreren met een bestaand HR-aanwezigheids- of ERP-systeem?
Ja. De RS485- en REST API-paden van de SDK ondersteunen beide integratie met HR-aanwezigheidsplatforms en ERP-systemen. Je moet bevestigen of je ERP een beschikbaar API-endpoint heeft of RS485 seriële communicatie ondersteunt. Het team van Ironman kan de API-documentatie van je systeem bekijken en adviseren over het juiste integratiepad voordat je bestelt.
V6: Wat gebeurt er als de API-verbinding met de draaipoort offline gaat?
Ironman-poorten met ingebouwde inloggegevens kunnen in offline modus blijven werken — de controller gebruikt lokaal gecachete toegangsregels om toegang goed te keuren of te weigeren. Zodra de API-verbinding herstelt, De poort synchroniseert gebeurtenislogs en eventuele inloggegevens worden automatisch bijgewerkt. Deze offline fallback is essentieel voor faciliteiten die geen poortuitval kunnen accepteren tijdens netwerkonderbrekingen.
Je integratie op gang brengen
Het juiste integratiepad komt neer op drie keuzes: Jouw softwaretype (Cloud of on-premise), Je type kwalificatie (QR-code, RFID, biometrisch), en je faciliteitsschaal. Ironman biedt een volledig SDK-pakket — interfaceboard, Protocoldocumentatie, API-referentie, en codevoorbeelden — met bevestigde poortorders, plus directe IT-ondersteuning tijdens het testen.
De wereldwijde markt voor toegangscontrole groeit tegen 4.08% CAGR, met draaipoortsystemen centraal in de beveiligingsimplementaties van ondernemingen. Het vanaf dag één goed krijgen van de software-integratie beschermt die investering op de lange termijn.
Vraag je SDK-pakket en projectspecificatie aan door contact op te nemen met het Ironman-team via onzeDraaihekhekken groothandel en projectpagina. Voeg je poortmodelvereiste toe, Soort kredenatie, en het softwareplatform te richten — en een technische reactie binnen te verwachten 12 Openingstijden.
