Turnstile Gate SDK & API: 開発者およびシステムインテグレーターのための統合ガイド
2026-03-25
アイアンマンのターンスタイルゲートは、チケットプラットフォームを含むサードパーティ製ソフトウェアシステムとの完全なSDKおよびAPI連携をサポートしています, 人事出席システム, ビジター管理ツール, および建物管理システム. このガイドでは、Turnstile Gate SDK APIパッケージに含まれる内容を説明します, どのAPIタイプがサポートされているか, Postmanを使ったライブ接続のテスト方法. もしあなたが開発者やシステムインテグレーターでターンスタイルサプライヤーを評価する場合, これが決断を下す前に必要とする技術的な参考資料です.
クラウド接続展開のために, 私たちのクラウドベースのターンスタイルゲートシステム — これらのモデルには、標準のネイティブAPIサポートが含まれています.
SDKと. API — ターンスタイル統合のためにそれぞれの役割
ターンスタイルゲートSDKとAPIは統合プロセスにおいて異なる役割を果たします. この違いを理解することで、セットアップ時間を節約し、新しいプロジェクトを始める際の最も一般的な技術的誤解を防ぎます.
ザSDK は完全な開発パッケージです. ドキュメントも含まれています, コードサンプル, 配線仕様, インターフェースボード, およびユーティリティのテスト. SDKはセットアップとビルドの段階で使います — ソフトウェアが稼働する前のことです.
ザAPI は、ソフトウェアが稼働中に呼び出すコマンドインターフェースです. ユーザーがゲートで認証情報を提示するたびに, プラットフォームがAPIリクエストを送信します, そしてターンスタイルコントローラーが結果を返します.
| SDK | API | |
|---|---|---|
| それは何か | フル開発パッケージ | コマンドおよびデータインターフェース |
| 誰が使っているか | セットアップ中の現像液 | 稼働中のソフトウェア |
| その内容 | ドキュメンタリー, コードサンプル, インターフェースボード, テストツール | エンドポイント, パラメータ, 応答形式 |
| 必要なときに | 統合および試験段階 | 稼働後のすべてのゲートトランザクション |
こう考えてみてください: SDKは接続を構築するために使うものです. APIがその後に実行します.
IronmanのTurnstile Gate SDKパッケージに含まれる内容
IronmanにSDKパッケージをリクエストすると, あなたは単なる書類ファイル以上のものを受け取っています. このパッケージは、開発者が初日から動作する統合を完了するために必要なすべてをカバーしています.
ドキュメントおよび仕様ファイル
ドキュメントパッケージには以下が含まれます:
- ハードウェアプロトコル仕様: ウィーガント26ビットおよび34ビットの通信フォーマットを定義します, RS485シリアル, およびドライコンタクトリレー出力
- APIエンドポイント参照: 完全なコマンドリスト, パラメータ定義, および応答コードの記述
- 配線図: APIインターフェースボードからゲートの制御ポートへの接続レイアウト
- サポートされる資格の種類: RFID, QRコード, バイオ メトリック (ターミナルからのウィーガント出力), およびPIN入力
すべての文書はハードウェア注文とともに出荷されます. プロジェクトがカスタム認証マッピングや非標準プロトコルを必要とする場合, アイアンマンのエンジニアリングチームは出荷前に要件を確認します.
ソフトウェアツールとサンプルコード
SDKのソフトウェア層には以下が含まれます:
- APIインターフェースボード: ターンスタイルコントローラーとソフトウェア環境をつなぐ物理的なハードウェアコンポーネント (ローカルサーバー, クラウドエンドポイント, またはオンプレミスのPC)
- コードサンプル: プロジェクトプラットフォームに基づく共通言語で提供されており、HTTP POSTリクエスト処理の統合例も含まれています
- テストユーティリティ: 本番システムに接続する前にAPI呼び出し成功を確認するために使用されました
- 直接ITサポート: アイアンマンの技術チームはポストマンのテスト構成を支援し、最初のものの検証を行います 50 発注中のライブ取引
会場や交通プロジェクトでAPI統合を展開した経験から, インターフェースボードとドキュメントが一緒に解決します 90% 単一のサポートチケットが必要になる前に、統合に関する質問が多い.
アイアンマンターンスタイルゲートでサポートされるAPIタイプ
Ironmanのターンスタイルゲートは3つの主要なAPI統合パスをサポートしています. 正しい方法を選ぶのは、あなたのソフトウェアアーキテクチャによります, ネットワーク環境, および資格の種類.
REST API (HTTPベース)
REST APIは現代のソフトウェアプラットフォームにおける最も一般的な統合経路です. アプリケーションはターンスタイルのAPIエンドポイントにHTTP POSTまたはGETリクエストを送信します. コントローラはJSONペイロード(認証有効/無効)で応答します, ゲートの開閉状況, イベントタイムスタンプ.
この道筋はSaaSのチケットプラットフォームに適しています, ウェブベースの人事出勤システム, クラウドホストの訪問者管理ツール. サーバーとターンスタイルのインターフェースボード間でネットワーク接続(LANまたはインターネット)が必要です, モデルによって異なります.
SDK + インターフェースボード (ハードウェア-ソフトウェアブリッジ)
ネットワーク接続のない環境、オフライン施設を含む場合, 空気遮断の警備区域, または従来のオンプレミスERPシステムなど、インターフェースボードはRS485またはRS232を介してローカルサーバーやPCに直接接続されます.
SDKは、サーバーがゲート信号を読み込み、アクセス決定をコントローラーに書き戻すために必要なドライバーとライブラリファイルを提供します. この道筋は製造施設やオンプレミスのHRシステムを運用する企業キャンパスで一般的です.
ウィーガンドプロトコルソフトウェア層
認証情報リーダーがWiegandの26ビットまたは34ビット信号を出力する場合, SDKは、ソフトウェアがそれらの信号を解釈するために使用するパーサーライブラリを提供します. これは、RFIDカードリーダーがすでにターンスタイルコントローラーに接続されている人事出勤システムに特に重要です.
Wiegandは1960年代以来業界の事実上のプロトコルであり、既存のアクセス制御システムで最も広く導入されたハードウェア通信標準として今もなお存在します.
ステップバイステップAPI統合ワークフロー
ターンスタイルゲートSDKのAPI統合は、明確な6ステップのプロセスを経て完成します. ほとんどのプロジェクトはSDKパッケージを受け取ってから48〜72時間以内にゴーライブに到達します, 対象ソフトウェアプラットフォームがアクティブなAPIを持っている場合.
ステップ1–3: セットアップと接続
ステップ 1 — SDKパッケージをリクエストする: プロジェクトの仕様書(ゲートモデル)をIronmanにご連絡ください, 資格の種類 (QRコード, RFIDカード, 生体認証端末), そしてターゲットとなるソフトウェアプラットフォーム. エンジニアリングチームが互換性を確認し、パッケージを発送しました.
ステップ 2 — SDKパッケージを受け取る: APIインターフェースボードは郵送で、ドキュメントファイルはメールで受け取ります. ゲートキャビネットを開ける前にAPIエンドポイントの参照図と配線図を確認してください.
ステップ 3 — インターフェースボードの配線: 配線図を使ってインターフェースボードをターンスタイルゲートの制御ポートに接続します. システムの電源を入れ、基板のLEDステータスインジケーターがライブ接続を示しているか確認してください.
ステップ4–6: テストと稼働開始
ステップ 4 — APIエンドポイントの設定: ソフトウェアでインターフェースボードのローカルIPアドレスにHTTPリクエストを送信するように設定してください (LAN設置用) またはクラウドエンドポイント (クラウド接続モデルの場合).
ステップ 5 — 郵便配達員とのテスト: APIリファレンスドキュメントをPostmanに読み込んでください. サンプル認証ペイロードを用いてテスト用POSTリクエストを構築する — 例えば, チケットシステムが生成するQRコードの文字列です. リクエストを送信し、ゲートが期待されるJSON結果で応答するか確認します. IronmanのITチームがPostmanの設定を確認し、必要に応じてテスト結果を直接検証できます.
ステップ 6 — あなたの生産システムに接続: 郵便配達員の試験に合格すれば, ライブソフトウェアも同じエンドポイントに向けてください. 最初の方を監視してください 50 テスト環境を除去する前の実際のトランザクション. 堅信後, この統合は本番環境に対応可能です.
一般的なユースケースと互換性のあるソフトウェアシステム
ターンスタイルゲートSDKは、業界を超えた幅広いソフトウェアプラットフォームをサポートしています. これらはアイアンマンのエンジニアリングチームが扱う最も一般的な4つの展開シナリオです.
- チケット販売と会場管理: 利用者の携帯電話や印刷されたチケットのQRコードがゲートでスキャンされます. APIはQR文字列をチケットプラットフォームに送信します, 有効/無効の応答を返します. ゲートは有効な応答がなければ開きません. スタジアムでの使用, コンサート会場, 展示ホール, そしてテーマパーク.
- 人事の出勤と勤務時間の管理: RFIDカードや指紋認証は人事システムへのAPI呼び出しをトリガーします. システムは入力時間を記録します, 従業員ID, そしてゲートレーン. 製造工場での使用, 物流センター, および企業オフィス.
- 来訪者管理システム (VMS): 事前登録済みの来訪者はメールで一度限りのQRコードを受け取ります. ゲートでスキャンされたとき, APIはコードをVMSに対して検証し、ホストに通知します. フロントデスクでのチェックインは不要です.
- ビル管理システム (BMS): ゲートはRS485を介してBMSコントローラに接続されます. ゲートの現状, 通過点数, アラームイベントはリアルタイムで建物のダッシュボードに入力されます.
Lenelのようなエンタープライズプラットフォーム向けに, ジェネテック, ブリボ, またはハネウェル・プロ・ウォッチ, APIパスを確認します (REST または RS485 SDK) アイアンマンチームとの連携はプラットフォームバージョンによって異なります.
対して全高のセキュリティ改札機設置 政府や高警備施設で, 同じSDKが適用され、統合レイヤーはゲートフォームファクターによって変わりません.
開発者向けハードウェアプロトコル参照
適切なハードウェアプロトコルの選択は、どんな統合プロジェクトでも最初に決断することです. この表はアイアンマンのターンスタイルゲートがサポートする主要なプロトコルを示しています, 技術的限界, そしてそれぞれに最適なユースケース.
| プロトコル | 種類 | 分布域 | 回線ごとのデバイス数 | 最適なユースケース |
|---|---|---|---|---|
| ウィーガント 26/34ビット | ハードウェア | ≤150m | 1 コントローラーポートごとに | RFIDリーダー→コントローラ |
| RS485 | 連続ドラマ | ≤1,200m | 最大で 32 | パネルからゲートへ, BMS統合 |
| RS232 | 連続ドラマ | ≤13m | 1 ポートごとに | デバッグ, ファームウェアアップデート |
| ドライコンタクト (VFC) | ハードウェア | 短距離 | 該当なし | シンプルなオープン/クローズリレー |
| REST API (HTTP) | ソフトウェア | LAN/インターネット | 無制限 | クラウドチケット, 人事, VMS |
| OSDP V2 | ハードウェア | ≤1,200m | 多重 | 高セキュリティ, AES-128暗号化 |
純粋なソフトウェア統合の場合: REST APIが正しいパスです. ネットワーク環境におけるハードウェアとソフトウェアのブリッジ用: SDKインターフェースボード搭載のRS485が標準です. OSDP V2は、特に政府関係でAES-128暗号化リーダー通信を必要とする展開に推奨されています, 医療, およびデータセンターアクセスポイント.
デプロイメントのプロジェクト用スマートスピードゲート改札口 高スループットエントリで, LAN経由のREST APIが推奨される統合経路であり、1レーンあたり40〜60人の持続的な取引速度をキュー遅延なく処理します.
よくある質問
Q1: ターンスタイルゲートSDKとAPIの違いは何ですか??
SDKは統合を構築するための完全な開発パッケージであり、ドキュメントも含まれています, コードサンプル, APIインターフェースボード, およびテストツール. APIは、ソフトウェアが稼働中に呼び出すコマンドインターフェースです. 接続を設定するにはSDKが必要です. ゲートが認証情報を処理するたびに、起動後にAPIを使います.
Q2: IronmanのターンスタイルゲートSDKはQRコードと生体認証統合に対応していますか??
はい. SDKはREST APIを介したQRコード検証をサポートしています (あなたのチケットやVMSプラットフォームがQR応答を提供します), Wiegand 26/34ビットによるRFIDカード読み取り, そしてウィーガンド信号を出力する生体認証端末. 独自プロトコルを搭載した顔認識端末向け, Ironmanのエンジニアリングチームは互換性を確認してからSDKパッケージを確定します.
Q3: ターンスタイルゲートSDKは無料ですか?それとも追加料金ですか?
SDKのドキュメントとAPIリファレンスは、ゲート注文が確認された場合に追加料金なしで提供されます. APIインターフェースボードはゲートに付属する物理的なハードウェアコンポーネントです. ご注文およびプロジェクト範囲に合ったSDKの加入については、Ironmanの営業チームまでお問い合わせください.
Q4: ターンスタイルAPI統合の完了にはどのくらい時間がかかりますか?
ほとんどの統合はSDKパッケージを受け取ってから48〜72時間以内にゴーライブに到達します, 対象ソフトウェアプラットフォームにアクティブなAPIとテスト可能な開発者が存在する場合. より複雑なマルチゲートやERP統合は5〜10営業日かかることもあります. アイアンマンのITチームはテスト段階で直接サポートを提供します, これにより、やり取りが大幅に減ります.
Q5: 既存の人事出勤やERPシステムと改札ゲートを統合できますか??
はい. SDKのRS485およびREST APIパスは、人事出席プラットフォームやERPシステムとの統合の両方をサポートしています. ERPに利用可能なAPIエンドポイントがあるか、RS485シリアル通信をサポートしているかを確認する必要があります. IronmanのチームがシステムのAPIドキュメントを確認し、注文前に正しい統合経路についてアドバイスします.
Q6: もしターンスタイルゲートへのAPI接続がオフラインになったらどうなるか?
アイアンマンのターンスタイルゲートは、オンボード認証情報ストレージを備え、オフラインモードで動作を続けられます。コントローラーはローカルキャッシュされたアクセスルールを使って入場を承認または拒否します. API接続が復旧すると, ゲートはイベントログや認証情報の更新を自動的に同期します. このオフラインのフォールバックは、ネットワーク中断時にゲートダウンタイムを受け入れられない施設にとって不可欠です.
統合の始め方
正しい統合の道は三つの選択肢に集約されます: あなたのソフトウェアの種類 (クラウドまたはオンプレミス), あなたの資格の種類 (QRコード, RFID, バイオ メトリック), そして施設スケール. Ironmanは完全なSDKパッケージ(インターフェースボード)を提供しています, プロトコル文書, API参照, およびコードサンプル — 確認済みゲート命令付き, さらにテスト中の直接ITサポートも加わります.
世界のアクセスコントロール市場は成長しています。 4.08% 年平均成長率, 企業のセキュリティ展開の中心にターンスタイルゲートシステムを据えています. 初日からソフトウェア統合を正しく行うことで、その投資は長期的に守られます.
Ironmanチームにご連絡いただき、SDKパッケージおよびプロジェクト仕様をご依頼ください改札口の卸売およびプロジェクトページ. ゲートモデルの要件を含めてください, 資格の種類, そしてターゲットソフトウェアプラットフォームを標的とし、技術的な対応を期待しています 12 営業時間.
