SDK de porte tourniquet & API: Guide d’intégration pour les développeurs et intégrateurs de systèmes
2026-03-25
Les portes de tourniquets d’Ironman supportent l’intégration complète SDK et API avec des systèmes logiciels tiers — y compris les plateformes de billetterie, Systèmes de présence RH, Outils de gestion des visiteurs, et systèmes de gestion de bâtiments. Ce guide explique ce que contient le paquet API SDK du portail tourniquet, quels types d’API sont pris en charge, et comment tester une connexion en direct avec Postman. Si vous êtes développeur ou intégrateur de systèmes évaluant un fournisseur de tourniquets, C’est la référence technique dont vous avez besoin avant de prendre une décision.
Pour les déploiements connectés au cloud, voir notreSystèmes de portails à tourniquets basés sur le cloud — ces modèles incluent un support natif d’API dès la sortie de la boîte.
SDK vs. API — À quoi sert chacune pour l’intégration des tourniquets
Un SDK de porte tourniquet et une API remplissent des rôles différents dans le processus d’intégration. Comprendre cette distinction fait gagner du temps de mise en place et évite les malentendus techniques les plus courants lors du lancement d’un nouveau projet.
LeSDK est le paquet de développement complet. Il inclut de la documentation, Exemples de code, Spécifications du câblage, Une carte d’interface, et utilitaires de test. Vous utilisez le SDK pendant la phase de configuration et de compilation — avant que votre logiciel ne soit opérationnel.
LeAPI est l’interface de commande que votre logiciel appelle pendant le fonctionnement en temps réel. Chaque fois qu’un utilisateur présente une carte d’identité à la porte, votre plateforme envoie une requête API, et le contrôleur de tourniquet répond par un résultat.
| SDK | API | |
|---|---|---|
| Ce que c’est | Paquet de développement complet | Interface de commande et de données |
| Qui l’utilise | Développeur lors de la configuration | Logiciel en fonctionnement en temps réel |
| Ce qu’il contient | Docs, Exemples de code, interface board, Outils de test | Points d’extrémité, Paramètres, Formats de réponse |
| Quand tu en as besoin | Phase d’intégration et de tests | Chaque transaction de porte après la mise en service |
Pensez-y ainsi: Le SDK est ce que vous utilisez pour construire la connexion. C’est l’API qui l’exécute ensuite.
Ce que contient le pack SDK de la porte tourniquet d’Ironman
Lorsque vous demandez un forfait SDK à Ironman, Vous recevez plus qu’un simple dossier documentaire. Le package couvre tout ce dont un développeur a besoin pour mener à bien une intégration fonctionnelle dès le premier jour.
Fichiers de documentation et de spécifications
Le dossier de documentation comprend:
- Spécification du protocole matériel: Définit le format de communication pour Wiegand 26 bits et 34 bits, Série RS485, et sorties de relais à contact sec
- Référence API endpoint: Liste complète des commandements, Définitions des paramètres, et descriptions des codes de réponse
- Schéma de câblage: Disposition de la connexion de la carte d’interface API vers le port de contrôle de la porte
- Types de titres pris en charge: RFID, Code QR, biométrique (Sortie Wiegand depuis le terminal), et entrée PIN
Chaque document est livré avec l’ordre matériel. Si votre projet nécessite une correspondance personnalisée des identifiants ou des protocoles non standards, L’équipe d’ingénierie d’Ironman examine les exigences avant l’expédition.
Outils logiciels et code d’exemple
La couche logicielle du SDK comprend:
- Carte d’interface API: Un composant matériel physique qui relie le contrôleur de tourniquets à votre environnement logiciel (Serveur local, point de terminaison cloud, ou PC sur site)
- Exemples de code: Fourni dans des langages courants basés sur votre plateforme de projet — y compris des exemples d’intégration pour la gestion des requêtes HTTP POST
- Utilitaires de test: Utilisé pour vérifier le succès des appels API avant de se connecter à un système de production
- Support informatique direct: L’équipe technique d’Ironman assiste à la configuration des tests Postman et valide le premier 50 Transactions en direct pendant la mise en service
D’après notre expérience dans le déploiement d’intégrations API pour des projets de lieux et de transports, La carte d’interface et la documentation se résolvent ensemble 90% d’intégration avant qu’un seul ticket de support ne soit nécessaire.
Types d’API pris en charge par les grilles tourniquets Ironman
Les portes tourniquets d’Ironman supportent trois chemins principaux d’intégration API. Le bon choix dépend de votre architecture logicielle, Environnement réseau, et type de titre.
REST API (Basé sur HTTP)
L’API REST est la voie d’intégration la plus courante pour les plateformes logicielles modernes. Votre application envoie des requêtes HTTP POST ou GET au point d’arrivée API du tourniquet. Le contrôleur répond par une charge utile JSON — valide/invalide de la validité, Statut de porte ouverte/fermée, et un horodatage d’événement.
Cette voie convient aux plateformes de billetterie SaaS, Systèmes de présence RH basés sur le web, et des outils de gestion des visiteurs hébergés dans le cloud. Il nécessite une connexion réseau entre votre serveur et la carte d’interface du tourniquet — soit en LAN soit internet, selon le modèle.
SDK + Interface Board (Pont matériel-logiciel)
Pour les environnements sans connexion réseau — y compris les fonctionnalités hors ligne, Zones de sécurité isolées, ou systèmes ERP on-premise legacy — la carte d’interface se connecte directement à un serveur local ou à un PC via RS485 ou RS232.
Le SDK fournit les fichiers de pilotes et de bibliothèques dont votre serveur a besoin pour lire les signaux de porte et écrire les décisions d’accès au contrôleur. Cette voie est courante dans les usines de fabrication et les campus d’entreprise qui utilisent des systèmes RH sur site.
Couche logicielle du protocole Wiegand
Lorsque les lecteurs d’identifiants émettent des signaux Wiegand 26 ou 34 bits, le SDK fournit la bibliothèque d’analyseurs que votre logiciel utilise pour interpréter ces signaux. Cela est particulièrement pertinent pour les systèmes de présence RH où les lecteurs de cartes RFID sont déjà câblés au contrôleur de tourniquets.
Wiegand est le protocole de facto de l’industrie depuis les années 1960 et reste la norme de communication matérielle la plus répandue installée dans les systèmes de contrôle d’accès existants.
Flux de travail d’intégration d’API étape par étape
L’intégration d’une API SDK à porte de tourniquet suit un processus clair en six étapes. La plupart des projets sont en mise en service dans les 48 à 72 heures suivant la réception du forfait SDK, à condition que la plateforme logicielle cible dispose d’une API active.
Étapes 1 à 3: Installation et connexion
Pas 1 — Demandez votre forfait SDK: Contactez Ironman avec les spécifications de votre projet — le modèle de la porte, Type de certification (Code QR, Carte RFID, Terminal biométrique), et votre plateforme logicielle cible. L’équipe d’ingénierie confirme la compatibilité et expédie le colis.
Pas 2 — Recevoir le paquet SDK: Vous recevez le tableau d’interface API par courrier et les fichiers de documentation par e-mail. Vérifiez la référence du point d’arrivée API et le schéma de câblage avant d’ouvrir l’armoire à grilles.
Pas 3 — Câbler la carte d’interface: Connectez la carte d’interface au port de contrôle du portail de tourniquet à l’aide du schéma électrique. Allumez le système et confirmez que les indicateurs d’état LED sur la carte indiquent une connexion active.
Étapes 4 à 6: Tests et mise en service
Pas 4 — Configurer le point de terminaison de l’API: Configurez votre logiciel pour envoyer des requêtes HTTP à l’adresse IP locale de la carte d’interface (pour les installations LAN) ou point d’accès cloud (pour les modèles connectés au cloud).
Pas 5 — Test avec le facteur: Chargez le document de référence API dans Postman. Construire une requête POST de test avec une charge utile d’identifiants d’exemple — par exemple, une chaîne de code QR que votre système de billetterie générerait. Envoyez la demande et confirmez que la porte répond avec le résultat JSON attendu. L’équipe informatique d’Ironman peut examiner votre installation Postman et valider directement les résultats des tests si nécessaire.
Pas 6 — Connectez-vous à votre système de production: Une fois les tests Postman réussis, Orientez votre logiciel en direct vers le même point de terminaison. Surveillez la première 50 Real Transactions avant de supprimer l’environnement de test. Après confirmation, L’intégration est prête à la production.
Cas d’usage courants et systèmes logiciels compatibles
L’API SDK à porte de tourniquets prend en charge un large éventail de plateformes logicielles à travers les secteurs. Voici les quatre scénarios de déploiement les plus courants que l’équipe d’ingénierie d’Ironman gère.
- Billetterie et gestion des lieux: Un code QR sur le téléphone de l’utilisateur ou un billet imprimé est scanné à la porte d’entrée. L’API envoie la chaîne QR à la plateforme de ticketing, qui renvoie une réponse valide/invalide. La porte ne s’ouvre qu’en cas de réponse valable. Utilisation dans les stades, Salles de concert, Salles d’exposition, et parcs à thème.
- Présence RH et suivi du temps: Une carte RFID ou un scan d’empreintes digitales déclenche un appel API vers le système RH. Le système enregistre le temps d’entrée, ID employé, et Gate Lane. Utilisation dans les usines de fabrication, Centres logistiques, et bureaux corporatifs.
- Systèmes de gestion des visiteurs (VMS): Un visiteur préenregistré reçoit un code QR à usage unique par e-mail. Lorsqu’il est scanné à la porte, l’API valide le code par rapport à la VMS et notifie l’hôte. Pas besoin d’enregistrement à la réception.
- Systèmes de gestion de bâtiments (BMS): La porte se connecte via RS485 au contrôleur BMS. Statut de la porte d’embarquement, Nombre de passages, et les événements d’alarme sont diffusés en temps réel dans le tableau de bord du bâtiment.
Pour les plateformes d’entreprise telles que Lenel, Genetec, Brivo, ou Honeywell Pro-Watch, confirmer le chemin de l’API (SDK REST ou RS485) avec l’équipe Ironman avant de spécifier — la compatibilité varie selon la version de la plateforme.
PourDéploiements de tourniquets de sécurité à pleine hauteur dans des installations gouvernementales ou à haute sécurité, le même SDK s’applique — la couche d’intégration ne change pas en fonction du facteur de forme de la porte.
Référence du protocole matériel pour les développeurs
Choisir le bon protocole matériel est la première décision dans tout projet d’intégration. Ce tableau présente les protocoles principaux pris en charge par les portes de tourniquets Ironman, leurs limites techniques, et le meilleur cas d’usage pour chacun.
| Protocole | Type | Répartition | Appareils par ligne | Meilleur cas d’utilisation |
|---|---|---|---|---|
| Wiegand 26/34 bits | Matériel | ≤150 m | 1 par port de contrôleur | Lecteur → contrôle RFID |
| RS485 | Feuilleton | ≤1 200 m | Jusqu’à 32 | De la porte à la grille, Intégration avec le BMS |
| RS232 | Feuilleton | ≤13m | 1 par port | Débogage, Mise à jour du firmware |
| Contact sec (VFC) | Matériel | Courte portée | N/A | Relais simple d’ouverture/fermeture |
| REST API (HTTP) | Logiciel | LAN/Internet | Illimité | Billetterie cloud, RH, VMS |
| OSDP V2 | Matériel | ≤1 200 m | Multiple | Haute sécurité, AES-128 chiffré |
Pour les intégrations purement logicielles: L’API REST est le chemin correct. Pour le pontage matériel-logiciel dans les environnements en réseau: Le RS485 avec la carte d’interface SDK est de série. L’OSDP V2 est recommandé pour les déploiements nécessitant une communication par lecteur chiffré AES-128 — particulièrement pertinent pour le gouvernement, Santé, et points d’accès aux centres de données.
Pour les projets en déploiementTourniquets de porte intelligente aux entrées à haut débit, L’API REST via LAN est la voie d’intégration privilégiée — elle gère des taux de transaction soutenus de 40 à 60 personnes par minute par voie sans délais de file d’attente.
Questions fréquemment posées
Q1: Quelle est la différence entre un SDK de porte de tourniquet et une API?
Le SDK est le package de développement complet que vous utilisez pour construire l’intégration — il inclut la documentation, Exemples de code, une carte d’interface API, et outils de test. L’API est l’interface de commande que votre logiciel appelle pendant le fonctionnement en temps réel. Vous avez besoin du SDK pour configurer la connexion. Vous utilisez l’API à chaque fois que la porte traite un identifiant après la mise en service.
Q2: Le SDK du portail de tourniquets Ironman supporte-t-il l’intégration du code QR et de la biométrie?
Oui. Le SDK prend en charge la validation du code QR via l’API REST (votre plateforme de tickets ou VMS fournit la réponse QR), Lecture de cartes RFID via Wiegand 26/34 bits, et des terminaux biométriques qui émettent un signal Wiegand. Pour les terminaux de reconnaissance faciale avec protocoles propriétaires, L’équipe d’ingénierie d’Ironman examine la compatibilité avant de confirmer le package SDK.
Q3: Le SDK du portail de tourniquet est-il gratuit ou est-ce que ça coûte un supplément?
La documentation du SDK et la référence API sont fournies sans frais supplémentaires avec des commandes de porte confirmées. La carte d’interface API est un composant matériel physique livré avec la porte. Contactez l’équipe commerciale Ironman pour confirmer l’inclusion du SDK dans votre commande spécifique et le périmètre du projet.
Q4: Combien de temps faut-il pour finaliser l’intégration d’une API de tourniquets?
La plupart des intégrations atteignent la mise en service dans les 48 à 72 heures suivant la réception du package SDK, à condition que la plateforme logicielle cible dispose d’une API active et d’un développeur disponible pour les tests. Les intégrations multi-portes ou ERP plus complexes peuvent prendre de 5 à 10 jours ouvrables. L’équipe informatique d’Ironman assure un support direct pendant la phase de test, ce qui réduit considérablement les allers-retours.
Q5: Puis-je intégrer une porte de tourniquet avec un système existant de présence RH ou ERP?
Oui. Les chemins RS485 et REST API du SDK supportent tous deux l’intégration avec les plateformes d’assiduité RH et les systèmes ERP. Vous devrez vérifier que votre ERP dispose d’un point de terminaison API disponible ou supporte la communication série RS485. L’équipe d’Ironman peut consulter la documentation de l’API de votre système et vous conseiller sur la bonne voie d’intégration avant votre commande.
Q6: Que se passe-t-il si la connexion API au portail tourniquet est hors ligne?
Les portes de tourniquets Ironman avec stockage d’identifiants embarqué peuvent continuer à fonctionner en mode hors ligne — le contrôleur utilise des règles d’accès en cache locale pour approuver ou refuser l’entrée. Une fois la connexion API rétablie, La porte synchronise automatiquement les journaux d’événements et toutes les mises à jour des identifiants. Ce plan de secours hors ligne est essentiel pour les installations qui ne peuvent pas accepter les interruptions de porte lors des interruptions réseau.
Lancer votre intégration
Le bon chemin d’intégration se résume à trois choix: votre type de logiciel (Cloud ou sur site), Votre type de diplôme (Code QR, RFID, biométrique), et votre échelle d’installation. Ironman fournit un ensemble SDK complet — carte d’interface, Documentation du protocole, Référence API, et des exemples de code — avec des ordres de porte confirmés, ainsi qu’un support informatique direct pendant les tests.
Le marché mondial du contrôle d’accès connaît une croissance à 4.08% TCAC, avec les systèmes de portails à tourniquets au cœur des déploiements de sécurité en entreprise. Avoir une intégration logicielle correcte dès le premier jour protège cet investissement sur le long terme.
Demandez votre dossier SDK et les spécifications de votre projet en contactant l’équipe Ironman via notrePortes tourniquets en gros et page de projet. Incluez votre exigence pour le modèle de porte, Type de certification, et la plateforme logicielle cible — et s’attendre à une réponse technique au sein 12 Heures d’ouverture.
