Turnstile Gate SDK & API: Integrationsleitfaden für Entwickler und Systemintegratoren
2026-03-25
Die Drehkreuz-Tore von Ironman unterstützen vollständige SDK- und API-Integration mit Drittanbieter-Softwaresystemen – einschließlich Ticketing-Plattformen, HR-Anwesenheitssysteme, Besuchermanagement-Tools, und Gebäudemanagementsysteme. Dieser Leitfaden behandelt, was das Drehkreuz-SDK-API-Paket enthält, welche API-Typen unterstützt werden, und wie man eine Live-Verbindung mit Postman testet. Wenn Sie als Entwickler oder Systemintegrator einen Lieferanten für Drehkreuze bewerten, Das ist die technische Referenz, die Sie benötigen, bevor Sie eine Entscheidung treffen.
Für cloud-verbundene Deployments, Siehe unsereCloudbasierte Drehkreuz-Gate-Systeme – diese Modelle bieten ab Werk nativ API-Unterstützung.
SDK vs. API — Was jeder für die Integration von Drehkreuzen macht
Ein Drehkreuz-SDK und eine API erfüllen unterschiedliche Aufgaben im Integrationsprozess. Das Verständnis des Unterschieds spart Einrichtungszeit und verhindert das häufigste technische Missverständnis beim Start eines neuen Projekts.
DasSDK ist das komplette Entwicklungspaket. Sie enthält Dokumentation, Codebeispiele, Verkabelungsspezifikationen, Eine Schnittstellenplatine, und Testprogramme. Sie verwenden das SDK während der Einrichtungs- und Build-Phase – also bevor Ihre Software live geht.
DasAPI ist die Befehlsschnittstelle, die Ihre Software während des Live-Betriebs aufruft.. Jedes Mal, wenn ein Nutzer am Gate eine Zugangsdaten vorlegt, deine Plattform sendet eine API-Anfrage, und der Drehkreuzregler reagiert mit einem Ergebnis.
| SDK | API | |
|---|---|---|
| Was es ist | Komplettes Entwicklungspaket | Befehls- und Datenschnittstelle |
| Wer benutzt es | Entwickler während der Einrichtung | Software während des Livebetriebs |
| Was es enthält | Docs, Codebeispiele, Schnittstellenplatine, Testwerkzeuge | Endpunkte, Parameter, Antwortformate |
| Wenn du es brauchst | Integrations- und Testphase | Jede Gate-Transaktion nach dem Go-Live |
Stell es dir so vor: das SDK ist das, womit du die Verbindung aufbaust. Die API ist das, was danach ausgeführt wird.
Was das Turnstile Gate SDK-Paket von Ironman enthält
Wenn Sie ein SDK-Paket von Ironman anfordern, Sie erhalten mehr als nur eine Dokumentenakte. Das Paket deckt alles, was ein Entwickler benötigt, um eine funktionierende Integration von Anfang an abzuschließen.
Dokumentations- und Spezifikationsdateien
Das Dokumentationspaket umfasst:
- Hardwareprotokollspezifikation: Definiert das Kommunikationsformat für Wiegand 26-Bit und 34-Bit, RS485-Seriennummer, und Trockenkontaktrelais-Ausgänge
- API-Endpunktreferenz: Vollständige Befehlsliste, Parameterdefinitionen, und Beschreibungen von Antwortcodes
- Schaltplan: Verbindungslayout der API-Schnittstellenplatine zum Steuerport des Gates
- Unterstützte Zugangsdaten: RFID, QR-Code, biometrisch (Wiegan-Ausgabe vom Terminal), und PIN-Eingabe
Jedes Dokument wird mit der Hardware-Bestellung geliefert. Wenn Ihr Projekt benutzerdefinierte Zugangsdaten oder nicht-standardisierte Protokolle erfordert,, Das Engineering-Team der Ironman überprüft die Anforderungen vor dem Versand.
Softwaretools und Beispielcode
Die Softwareschicht des SDK umfasst:
- API-Schnittstellenplatine: Eine physische Hardwarekomponente, die den Drehkreuz-Controller mit deiner Softwareumgebung verbindet (Lokaler Server, Cloud-Endpunkt, oder ein On-Premise-PC)
- Codebeispiele: Bereitgestellt in gängigen Sprachen basierend auf Ihrer Projektplattform – einschließlich Integrationsbeispielen für die Behandlung von HTTP-POST-Anfragen
- Test-Utilities: Wird verwendet, um den Erfolg eines API-Aufrufs vor der Verbindung zu einem Produktionssystem zu überprüfen
- Direkter IT-Support: Das technische Team von Ironman unterstützt bei der Testkonfiguration von Postman und validiert die erste 50 Live-Transaktionen während der Indienststellung
Nach unserer Erfahrung mit der Implementierung von API-Integrationen für Standort- und Nahverkehrsprojekte, Das Interface-Board und die Dokumentation lösen sich gemeinsam auf 90% Integrationsfragen, bevor ein einzelnes Support-Ticket benötigt wird.
API-Typen, die von Ironman-Drehkreuz-Gates unterstützt werden
Die Drehkreuzgatter von Ironman unterstützen drei primäre API-Integrationspfade. Das richtige hängt von deiner Softwarearchitektur ab, Netzwerkumgebung, und Zertifikatstyp.
REST API (HTTP-basiert)
Die REST API ist der gebräuchlichste Integrationsweg für moderne Softwareplattformen. Ihre Anwendung sendet HTTP-POST- oder GET-Anfragen an den API-Endpunkt des Drehkreuzes. Der Controller antwortet mit einer JSON-Nutzlast – Zugangsdaten gültig/ungültig, Gate-Open/Closed-Status, und einen Ereigniszeitstempel.
Dieser Weg eignet sich für SaaS-Ticketing-Plattformen, webbasierte HR-Anwesenheitssysteme, und cloudgehostete Besuchermanagement-Tools. Es erfordert eine Netzwerkverbindung zwischen Ihrem Server und der Schnittstelle des Drehkreuzes – entweder LAN oder Internet, Je nach Modell.
SDK + Schnittstellenplatine (Hardware-zu-Software-Brücke)
Für Umgebungen ohne Netzwerkverbindung – einschließlich Offline-Einrichtungen, Sicherheitszonen mit Luftsperren, oder ältere On-Premise-ERP-Systeme – die Schnittstellenplatine verbindet sich direkt über RS485 oder RS232 mit einem lokalen Server oder PC.
Das SDK stellt die Treiber- und Bibliotheksdateien bereit, die Ihr Server benötigt, um Gate-Signale zu lesen und Zugriffsentscheidungen zurück an den Controller zu schreiben.. Dieser Weg ist üblich in Produktionsstätten und auf Unternehmensgeländen, die vor Ort HR-Systeme betreiben.
Wiegand-Protokoll-Softwareschicht
Wenn Zugangsleser Wiegand 26-Bit- oder 34-Bit-Signale ausgeben,, das SDK stellt die Parser-Bibliothek bereit, die Ihre Software zur Interpretation dieser Signale verwendet. Dies ist besonders relevant für HR-Anwesenheitssysteme, bei denen RFID-Kartenleser bereits mit dem Drehkreuzregler verbunden sind.
Wiegand ist seit den 1960er Jahren das de-facto-Protokoll der Branche und bleibt der am weitesten verbreitete Hardware-Kommunikationsstandard in bestehenden Zugangskontrollsystemen.
Schritt-für-Schritt-API-Integrations-Workflow
Die Abschluss einer Drehkreuz-SDK-API-Integration erfolgt nach einem klaren sechsstufigen Prozess. Die meisten Projekte sind innerhalb von 48–72 Stunden nach Erhalt des SDK-Pakets in Betrieb, vorausgesetzt, die Zielsoftwareplattform verfügt über eine aktive API.
Schritte 1–3: Aufbau und Verbindung
Schritt 1 — Fordern Sie Ihr SDK-Paket an: Kontaktieren Sie Ironman mit Ihren Projektspezifikationen – dem Gate-Modell, Art von Qualifikation (QR-Code, RFID-Karte, Biometrisches Terminal), und Ihre Ziel-Softwareplattform. Das Ingenieurteam bestätigt die Kompatibilität und verschickt das Paket.
Schritt 2 — Das SDK-Paket empfangen: Sie erhalten das API-Interface-Board per Post und die Dokumentationsdateien per E-Mail. Überprüfen Sie die API-Endpunkt-Referenz und das Verdrahtungsdiagramm, bevor Sie das Gate-Cabinet öffnen.
Schritt 3 — Verkabeln Sie die Schnittstellenplatine: Verbinden Sie die Schnittstellenplatine mit dem Steueranschluss des Drehkreuzgatters über den Schaltplan. Schalten Sie das System ein und bestätigen Sie, dass die LED-Statusanzeigen auf der Platine eine aktive Verbindung anzeigen.
Schritte 4–6: Testen und Go-Live
Schritt 4 — Konfigurieren Sie den API-Endpunkt: Stellen Sie Ihre Software so ein, dass HTTP-Anfragen an die lokale IP-Adresse der Schnittstellenplatine gesendet werden (für LAN-Installationen) oder Cloud-Endpunkt (für cloud-verbundene Modelle).
Schritt 5 — Test mit Postboten: Lade das API-Referenzdokument in Postman. Erstellen Sie zum Beispiel eine Test-POST-Anfrage mit einer Beispiel-Credential-Nutzlast, eine QR-Code-Zeichenkette, die dein Ticketsystem erzeugt. Senden Sie die Anfrage und bestätigen, dass das Gate mit dem erwarteten JSON-Ergebnis antwortet. Das IT-Team von Ironman kann Ihre Postman-Einrichtung überprüfen und bei Bedarf die Testergebnisse direkt validieren.
Schritt 6 — Verbinden Sie sich mit Ihrem Produktionssystem: Sobald Postman-Tests bestanden haben, Lenke deine Live-Software auf denselben Endpunkt. Überwachen Sie das erste 50 reale Transaktionen vor dem Entfernen der Testumgebung. Nach der Konfirmation, Die Integration ist produktionsbereit.
Häufige Anwendungsfälle und kompatible Softwaresysteme
Die Drehkreuz-SDK-API unterstützt eine breite Palette von Softwareplattformen branchenübergreifend. Dies sind die vier häufigsten Einsatzszenarien, die das Engineering-Team von Ironman übernimmt.
- Ticketverkauf und Veranstaltungsortverwaltung: Ein QR-Code auf dem Handy des Nutzers oder ein ausgedrucktes Ticket wird am Gate eingescannt. Die API sendet den QR-String an die Ticketing-Plattform, wobei eine gültige/ungültige Antwort zurückgegeben wird. Das Tor öffnet sich nur bei einer gültigen Antwort. Verwendung in Stadien, Konzertorte, Ausstellungshallen, und Freizeitparks.
- HR-Anwesenheit und Zeiterfassung: Ein RFID-Karten- oder Fingerabdrucksscan löst einen API-Aufruf an das HR-System aus. Das System protokolliert die Eingabezeit, Mitarbeiter-ID, und Gate-Lane. Verwendung in Produktionsstätten, Logistikzentren, und Firmensitze.
- Besuchermanagementsysteme (VMS): Ein vorregistrierter Besucher erhält einen einmaligen QR-Code per E-Mail. Beim Scannen am Tor, die API validiert den Code gegen die VMS und benachrichtigt den Host. Kein Check-in an der Rezeption erforderlich.
- Gebäudemanagementsysteme (BMS): Das Gate verbindet sich über RS485 mit dem BMS-Controller. Gate-Status, Anzahl der Passagen, und Alarmereignisse werden in Echtzeit ins Gebäude-Dashboard eingespeist.
Für Unternehmensplattformen wie Lenel, Genetec, Brivo, oder Honeywell Pro-Watch, Bestätigen Sie den API-Pfad (REST oder RS485 SDK) mit dem Ironman-Team vor der Spezifikation – die Kompatibilität variiert je nach Plattformversion.
FürSicherheitsdrehkreuze in voller Höhe in Regierungs- oder Hochsicherheitseinrichtungen, dasselbe SDK gilt – die Integrationsschicht ändert sich nicht basierend auf dem Gate-Formfaktor.
Hardware-Protokollreferenz für Entwickler
Die Wahl des richtigen Hardwareprotokolls ist die erste Entscheidung in jedem Integrationsprojekt. Diese Tabelle zeigt die Hauptprotokolle, die Ironman-Drehkreuz-Gates unterstützen, ihre technischen Grenzen, und den besten Anwendungsfall für jede.
| Protokoll | Typ | Verbreitung | Geräte pro Leitung | Bester Anwendungsfall |
|---|---|---|---|---|
| Wiegand 26/34-bit | Hardware | ≤150 m | 1 pro Controller-Port | RFID-Leser → Controller |
| RS485 | Serial | ≤1.200 m | Bis 32 | Panel-zu-Tor, BMS-Integration |
| RS232 | Serial | ≤13 m | 1 pro Hafen | Debugging, firmware update |
| Dry Contact (VFC) | Hardware | Kurzstrecke | N/A | Einfaches Öffnen/Schließ-Relais |
| REST API (HTTP) | Software | LAN/Internet | Unbegrenzt | Cloud-Ticketing, HR, VMS |
| OSDP V2 | Hardware | ≤1.200 m | Mehrfach | Hochsicherheit, AES-128 verschlüsselt |
Für reine Softwareintegrationen: Die REST-API ist der korrekte Weg. Für Hardware-zu-Software-Brücken in vernetzten Umgebungen: RS485 mit der SDK-Schnittstellenplatine ist Standard. OSDP V2 wird für Implementierungen empfohlen, die eine verschlüsselte AES-128-Lesekommunikation erfordern – besonders relevant für die Regierung, Gesundheitswesen, sowie Rechenzentrum-Zugangspunkte.
Für Projekte im EinsatzIntelligente Drehkreuze mit Geschwindigkeitstor bei Hochdurchsatz-Einträgen, Die REST-API über LAN ist der bevorzugte Integrationsweg – sie bewältigt anhaltende Transaktionsraten von 40–60 Personen pro Minute und Spur ohne Warteschlangenverzögerungen.
Häufig gestellte Fragen
Frage 1: Was ist der Unterschied zwischen einem Drehkreuz-SDK und einer API??
Das SDK ist das komplette Entwicklungspaket, das Sie zur Integration verwenden – es enthält Dokumentation, Codebeispiele, eine API-Schnittstellenplatine, und Testwerkzeuge. Die API ist die Befehlsschnittstelle, die Ihre Software während des Live-Betriebs aufruft.. Du brauchst das SDK, um die Verbindung einzurichten. Du nutzt die API jedes Mal, wenn das Gate nach dem Go-Live eine Zugangsdaten verarbeitet.
Frage 2: Unterstützt das Ironman-Drehkreuz-Gate-SDK QR-Code und biometrische Integration??
Ja. Das SDK unterstützt die QR-Code-Validierung über die REST API (Ihre Ticketing- oder VMS-Plattform liefert die QR-Antwort), RFID-Kartenlesung über Wiegand 26/34-Bit, und biometrische Terminals, die ein Wiegand-Signal ausgeben. Für Gesichtserkennungsterminals mit proprietären Protokollen, Das Engineering-Team von Ironman überprüft die Kompatibilität, bevor es das SDK-Paket bestätigt.
Frage 3: Ist das Drehkreuzgatter-SDK kostenlos oder kostet es extra.?
Die SDK-Dokumentation und API-Referenz werden bei bestätigten Gate-Bestellungen ohne zusätzliche Kosten bereitgestellt. Die API-Schnittstellenplatine ist eine physische Hardwarekomponente, die mit dem Gate ausgeliefert wird. Kontaktieren Sie das Ironman-Vertriebsteam, um die SDK-Aufnahme für Ihre spezifische Bestellung und Projektumfang zu bestätigen.
Frage 4: Wie lange dauert es, eine Drehkreuz-API-Integration abzuschließen??
Die meisten Integrationen sind innerhalb von 48–72 Stunden nach Erhalt des SDK-Pakets live, vorausgesetzt, die Zielplattform verfügt über eine aktive API und einen Entwickler zum Testen. Komplexere Multi-Gate- oder ERP-Integrationen können 5–10 Werktage dauern. Das IT-Team von Ironman unterstützt direkt während der Testphase, was das Hin und Her erheblich reduziert.
Frage 5: Kann ich ein Drehkreuz-Tor in ein bestehendes HR-Anwesenheits- oder ERP-System integrieren??
Ja. Die RS485- und REST-API-Pfade des SDK unterstützen beide die Integration mit HR-Anwesenheitsplattformen und ERP-Systemen. Sie müssen bestätigen, ob Ihr ERP einen verfügbaren API-Endpunkt hat oder RS485-serielle Kommunikation unterstützt. Das Team von Ironman kann die API-Dokumentation deines Systems prüfen und vor der Bestellung den richtigen Integrationspfad empfehlen.
F6: Was passiert, wenn die API-Verbindung zum Drehkreuz offline geht?
Ironman-Drehkreuz-Tore mit integrierter Zugangsspeicherung können weiterhin im Offline-Modus betrieben werden – der Controller verwendet lokal zwischengespeicherte Zugriffsregeln, um den Zutritt zu genehmigen oder zu verweigern. Sobald die API-Verbindung wiederhergestellt wird, Das Gate synchronisiert Ereignisprotokolle und aktualisierte Zugangsdaten automatisch. Dieser Offline-Fallback ist für Anlagen unerlässlich, die keine Gate-Ausfallzeiten während Netzwerkunterbrechungen akzeptieren können.
Der Einstieg in die Integration
Der richtige Integrationsweg lässt sich auf drei Optionen reduzieren: Deine Softwareart (Cloud oder On-Premise), Ihr Qualifikationstyp (QR-Code, RFID, biometrisch), und deine Einrichtungsgröße. Ironman bietet ein vollständiges SDK-Paket – Interface-Board –, Protokolldokumentation, API-Referenz, und Codebeispiele – mit bestätigten Torbefehlen, außerdem direkter IT-Support während des Tests.
Der globale Markt für Zugangskontrollen wächst zu 4.08% CAGR, Mit Drehkreuz-Gate-Systemen im Zentrum der Unternehmenssicherheit. Die Softwareintegration von Anfang an schützt diese Investition langfristig.
Fordern Sie Ihr SDK-Paket und Ihre Projektspezifikation an, indem Sie das Ironman-Team über unserDrehkreuz-Tore Großhandels- und Projektseite. Fügen Sie Ihre Gate-Modellanforderung hinzu, Art von Qualifikation, und die Softwareplattform ansprechen – und eine technische Antwort innerhalb des Bereichs erwarten 12 Geschäftszeiten.
