ערכת SDK לשערי הקורה & API: מדריך אינטגרציה למפתחים ואינטגרטורים של מערכות
2026-03-25
שערי הטורנסטל של Ironman תומכים באינטגרציה מלאה של SDK ו-API עם מערכות תוכנה צד שלישי — כולל פלטפורמות כרטיסים, מערכות נוכחות במשאבי אנוש, כלי ניהול מבקרים, ומערכות ניהול מבנים. מדריך זה מכסה מה מכיל חבילת ה-API של שער הטורנסטל, אילו סוגי API נתמכים, וכיצד לבדוק חיבור חי באמצעות Postman. אם אתה מפתח או אינטגרטור מערכות שמעריך ספק שערי קורה, זהו ההפניה הטכנית שאתה צריך לפני קבלת החלטה.
לפריסות מחוברות לענן, ראו את שלנומערכות שערי פניות מבוססות ענן — מודלים אלה כוללים תמיכה מקורית ב-API מובנית מראש.
SDK מול SDK. API — מה כל אחד מהם עושה לאינטגרציה עם שערי טורנסטל
SDK ו-API של שער טורנסטל ממלאים תפקידים שונים בתהליך האינטגרציה. הבנת ההבחנה חוסכת זמן הגדרה ומונעת את אי ההבנה הטכנית הנפוצה ביותר בתחילת פרויקט חדש.
הSDK היא חבילת הפיתוח המלאה. הוא כולל תיעוד, דוגמאות קוד, מפרט חיווט, לוח ממשק, ומתקני בדיקה. אתה משתמש ב-SDK במהלך שלב ההגדרה והבנייה — לפני שהתוכנה שלך עולה לאוויר.
הAPI הוא ממשק הפקודה שהתוכנה שלך קוראת לו במהלך פעולה חיה. בכל פעם שמשתמש מציג אישור מעבר לשער, הפלטפורמה שלך שולחת בקשת API, ובקר השערים מגיב בתוצאה.
| SDK | API | |
|---|---|---|
| מה זה | חבילת פיתוח מלאה | ממשק פיקוד ונתונים |
| מי משתמש בו | מפתח בזמן ההכנה | תוכנה במהלך הפעלה חיה |
| מה הוא מכיל | מסמכים, דוגמאות קוד, לוח ממשק, כלי בדיקה | נקודות קצה, פרמטרים, פורמטים של תגובה |
| כשאתה צריך את זה | שלב האינטגרציה והבדיקות | כל עסקת שער אחרי ההפעלה |
תחשוב על זה ככה: ה-SDK הוא מה שאתה משתמש בו כדי לבנות את החיבור. ה-API הוא זה שמפעיל אותו אחר כך.
מה מכיל חבילת ה-SDK של Ironman's Turnstile Gate
כשאתה מבקש חבילת SDK מאיירונמן, אתה מקבל יותר מקובץ תיעוד. החבילה מכסה את כל מה שמפתח צריך כדי להשלים אינטגרציה עובדת מהיום הראשון.
תיעוד וקבצי מפרט
חבילת התיעוד כוללת:
- מפרט פרוטוקול חומרה: מגדיר את פורמט התקשורת עבור וויגנד 26 ו-34 ביט, סדרת RS485, ויציאות ממסר מגע יבש
- הפניה לנקודת קצה API: רשימת הפקודות המלאה, הגדרות פרמטרים, ותיאורי קוד תגובה
- דיאגרמת חיווט: פריסת החיבור של לוח הממשק של ה-API ליציאת הבקרה של השער
- סוגי תעודות נתמכים: RFID, קוד QR, ביומטרי (פלט ויגנד מהטרמינל), וקלט PIN
כל מסמך נשלח עם הזמנת החומרה. אם הפרויקט שלך דורש מיפוי אישורים מותאם אישית או פרוטוקולים לא סטנדרטיים, צוות ההנדסה של איירונמן בודק את הדרישות לפני המשלוח.
כלי תוכנה וקוד לדוגמה
שכבת התוכנה של SDK כוללת:
- לוח ממשק API: רכיב חומרה פיזי שמחבר את בקר השערים לסביבת התוכנה שלך (שרת מקומי, נקודת קצה בענן, או מחשב אישי מקומי)
- דוגמאות קוד: מסופק בשפות נפוצות המבוססות על פלטפורמת הפרויקט שלך — כולל דוגמאות אינטגרציה לטיפול בקשות HTTP POST
- כלי בדיקה: משמש לאימות הצלחת שיחת ה-API לפני חיבור למערכת ייצור
- תמיכה ישירה ב-IT: הצוות הטכני של איירונמן מסייע בתצורת מבחן פוסטמן ומאמת את הבדיקה הראשונה 50 עסקאות חיות במהלך ההפעלה
מניסיוננו בפריסת אינטגרציות API לפרויקטים של מקומות ותחבורה, לוח הממשק והתיעוד יחד מתמודדים 90% שאלות אינטגרציה לפני שנדרש כרטיס תמיכה יחיד.
סוגי API הנתמכים על ידי שערי Ironman Turnstile
שערי השערים של Ironman תומכים בשלושה מסלולי אינטגרציה עיקריים של API. הנכון תלוי בארכיטקטורת התוכנה שלך, סביבת הרשת, וסוג הסמכה.
REST API (מבוסס HTTP)
REST API הוא נתיב האינטגרציה הנפוץ ביותר עבור פלטפורמות תוכנה מודרניות. האפליקציה שלך שולחת בקשות HTTP POST או GET לנקודת הקצה של ה-API של ה-turnstile. הבקר מגיב עם מטען JSON — אישור תקין/לא תקף, מצב שער פתוח/סגור, וחותמת זמן לאירוע.
מסלול זה מתאים לפלטפורמות כרטיסי SaaS, מערכות נוכחות משאבי אנוש מבוססות רשת, וכלי ניהול מבקרים בענן. זה דורש חיבור רשת בין השרת שלך ללוח הממשק של ה-turnstile — בין אם LAN או אינטרנט, תלוי בדגם.
SDK + לוח ממשק (גשר חומרה-לתוכנה)
לסביבות ללא חיבור רשת — כולל מתקנים לא מקוונים, אזורי אבטחה עם פערי אוויר, או מערכות ERP מקומיות ותיקות — לוח הממשק מתחבר ישירות לשרת מקומי או למחשב PC דרך RS485 או RS232.
ה-SDK מספק את קבצי הדרייבר והספרייה שהשרת שלך צריך כדי לקרוא אותות שער ולכתוב החלטות גישה חזרה לבקר. מסלול זה נפוץ במתקני ייצור ובקמפוסים עסקיים הפועלים מערכות משאבי אנוש מקומיות.
שכבת התוכנה של פרוטוקול ויגנד
כאשר קוראי האישורים מפיקים אותות Wiegand 26 ביט או 34 ביט, ה-SDK מספק את ספריית המנתח שהתוכנה שלך משתמשת בה כדי לפרש את האותות האלה. זה רלוונטי במיוחד למערכות נוכחות במשאבי אנוש שבהן קוראי כרטיסי RFID כבר מחוברים לבקר השערים.
ויגנד הוא הפרוטוקול דה פקטו בתעשייה מאז שנות ה-60 ונשאר התקן התקשורתי החומרתי המותקן ביותר במערכות בקרת גישה קיימות.
תהליך אינטגרציית API שלב אחר שלב
השלמת אינטגרציה עם SDK ל-API של שער טורים מתבצעת בתהליך ברור בן שישה שלבים. רוב הפרויקטים מגיעים להפעלה תוך 48–72 שעות מקבלת חבילת ה-SDK, בתנאי שלפלטפורמת התוכנה היעד יש API פעיל.
שלבים 1–3: הקמה וחיבור
צעד 1 — בקש את חבילת ה-SDK שלך: צור קשר עם איירונמן עם מפרט הפרויקט שלך — דגם השער, סוג הסמכה (קוד QR, כרטיס RFID, טרמינל ביומטרי), ופלטפורמת התוכנה היעד שלך. צוות ההנדסה מאשר את ההתאמה ושולח את החבילה.
צעד 2 — קבלת חבילת SDK: אתה מקבל את לוח הממשק של ה-API בדואר ואת קבצי התיעוד בדוא"ל. בדוק את ההפניה של נקודת הקצה של ה-API ודיאגרמת החיווט לפני פתיחת ארון השער.
צעד 3 — חבר את לוח הממשק: חבר את לוח הממשק ליציאת הבקרה של שער הטורנסטל באמצעות דיאגרמת החיווט. להפעיל את המערכת ולאשר שמדדי הסטטוס של ה-LED על הלוח מראים חיבור חי.
שלבים 4–6: בדיקות ושידור חי
צעד 4 — להגדיר את נקודת הקצה של ה-API: הגדר את התוכנה שלך לשלוח בקשות HTTP לכתובת ה-IP המקומית של לוח הממשק (להתקנות LAN) או נקודת קצה בענן (עבור מודלים מחוברים בענן).
צעד 5 — מבחן עם דוור: טען את מסמך ההפניה של ה-API ל-Postman. בנה בקשת POST לבדיקה עם מטען אישור לדוגמה — לדוגמה, מחרוזת קוד QR שמערכת הכרטיסים שלך תייצר. שלח את הבקשה ואשר שהשער מגיב עם התוצאה הצפויה של JSON. צוות ה-IT של איירונמן יכול לבדוק את מערכת הפוסטמן שלך ולאמת תוצאות בדיקה ישירות במידת הצורך.
צעד 6 — התחבר למערכת הייצור שלך: ברגע שמבחני הדוור עוברים, כוון את התוכנה החיה שלך לאותה נקודת קצה. לעקוב אחרי הראשון 50 עסקאות אמיתיות לפני הסרת סביבת הבדיקה. לאחר האישור, האינטגרציה מוכנה לייצור.
מקרי שימוש נפוצים ומערכות תוכנה תואמות
ממשק ה-API SDK של שער הטור תומך במגוון רחב של פלטפורמות תוכנה בתעשיות שונות. אלו ארבעת תרחישי הפריסה הנפוצים ביותר שצוות ההנדסה של איירונמן מטפל בהם.
- כרטיסים וניהול מקום: קוד QR בטלפון או בכרטיס המודפס של המשתמש נסרק בשער. ה-API שולח את מחרוזת ה-QR לפלטפורמת הכרטיסים, שמחזירה תגובה תקפה/לא תקפה. השער נפתח רק בתגובה תקפה. בשימוש באצטדיונים, אולמות קונצרטים, אולמות תצוגה, ופארקי שעשועים.
- נוכחות משאבי אנוש ומעקב זמן: כרטיס RFID או סריקת טביעת אצבע מפעילים קריאת API למערכת משאבי אנוש. המערכת מתעדת את זמן הכניסה, מזהה עובד, וליין שער. בשימוש במפעלי ייצור, מרכזי לוגיסטיקה, ומשרדים תאגידיים.
- מערכות ניהול מבקרים (VMS): מבקר רשום מראש מקבל קוד QR חד-פעמי בדוא"ל. כאשר נסרק בשער, ה-API מאמת את הקוד מול ה-VMS ומודיע למארח. אין צורך בצ'ק-אין בקבלה.
- מערכות ניהול מבנים (BMS): השער מתחבר דרך RS485 לבקר ה-BMS. סטטוס השער, ספירת המעברים, ואירועי אזעקה מזינים את לוח המחוונים של הבניין בזמן אמת.
לפלטפורמות ארגוניות כמו לנל, ג'נטק, בריבו, או Honeywell Pro-Watch, אשר את נתיב ה-API (REST או SDK ל-RS485) עם צוות איירונמן לפני שציינו — התאימות משתנה בגרסת הפלטפורמה.
בשבילפריסת שערי אבטחה בגובה מלא במתקנים ממשלתיים או בעלי אבטחה גבוהה, אותו SDK חל — שכבת האינטגרציה אינה משתנה בהתאם לצורת השער.
התייחסות לפרוטוקול חומרה למפתחים
בחירת פרוטוקול החומרה הנכון היא ההחלטה הראשונה בכל פרויקט אינטגרציה. טבלה זו מציגה את הפרוטוקולים העיקריים שבהם תומכים שערי הטורנסטל של איירונמן, הגבולות הטכניים שלהם, ואת מקרה השימוש הטוב ביותר לכל אחד מהם.
| פרוטוקול | סוג | תפוצה | התקנים לכל קו | מקרה שימוש מיטבי |
|---|---|---|---|---|
| ויגנד 26/34 ביט | חומרה | ≤150 מטר | 1 לכל פורט בקר | קורא RFID → בקר |
| RS485 | סידרה | ≤1,200 מטר | עד 32 | פאנל-ל-גייט, אינטגרציה עם BMS |
| RS232 | סידרה | ≤13 מטר | 1 לכל פורט | ניפוי שגיאות, עדכון קושחה |
| מגע יבש (VFC) | חומרה | טווח קצר | לא זמין | ממסר פתיחה/סגירה פשוט |
| REST API (HTTP) | תוכנה | LAN/אינטרנט | ללא הגבלה | כרטיסים בענן, משאבי אנוש, VMS |
| OSDP V2 | חומרה | ≤1,200 מטר | ריבוי | אבטחה גבוהה, AES-128 מוצפן |
לאינטגרציות תוכנה טהורה: REST API הוא הנתיב הנכון. לגשר חומרה-תוכנה בסביבות רשת: RS485 עם לוח ממשק SDK הוא סטנדרטי. OSDP V2 מומלץ לפריסות הדורשות תקשורת קוראים מוצפנת AES-128 — רלוונטי במיוחד לממשלה, בריאות, ונקודות גישה למרכזי נתונים.
לפרויקטים שמבצעים פריסהשערי מהירות חכמים בכניסות עם תפוקה גבוהה, REST API דרך LAN הוא נתיב האינטגרציה המועדף — הוא מטפל בקצב עסקאות מתמשך של 40–60 אנשים לדקה לכל נתיב ללא עיכובים בתור.
שאלות נפוצות
שאלה 1: מה ההבדל בין SDK של שער טורנסטריל לבין API?
ה-SDK הוא חבילת הפיתוח המלאה שבה אתה משתמש כדי לבנות את האינטגרציה — היא כוללת תיעוד, דוגמאות קוד, לוח ממשק API, וכלי בדיקה. ה-API הוא ממשק הפקודות שהתוכנה שלך קוראת לו במהלך הפעלה חיה. אתה צריך את ה-SDK כדי להגדיר את החיבור. אתה משתמש ב-API בכל פעם שהשער מעבד אישור אחרי ההפעלה.
שאלה 2: האם SDK של שער הטורנסטל של Ironman תומך בקוד QR ואינטגרציה ביומטרית?
כן. ה-SDK תומך באימות קוד QR באמצעות API REST (פלטפורמת הכרטיסים או ה-VMS שלך מספקת את תגובת ה-QR), קריאת כרטיס RFID באמצעות Wiegand 26/34 ביט, ומסופים ביומטריים שמפיקים אות ויגנד. למסופי זיהוי פנים עם פרוטוקולים קנייניים, צוות ההנדסה של Ironman בודק את התאימות לפני אישור חבילת ה-SDK.
שאלה 3: האם שער הפנייה חינך מ-SDK או שזה עולה תוספת?
תיעוד SDK וההפניה ל-API מסופקים ללא עלות נוספת עם פקודות שער מאושרות. לוח ממשק ה-API הוא רכיב חומרה פיזי שנשלח עם השער. צרו קשר עם צוות המכירות של Ironman כדי לאשר הכללת SDK עבור ההזמנה והיקף הפרויקט הספציפיים שלכם.
שאלה 4: כמה זמן לוקח להשלים אינטגרציה עם API של שערי טורנסtile?
רוב האינטגרציות מגיעות למצב הפעלה תוך 48–72 שעות מקבלת חבילת ה-SDK, בתנאי שלפלטפורמת התוכנה היעד יש API פעיל ומפתח זמין לבדיקה. אינטגרציות מורכבות יותר עם שערים מרובים או ERP עשויות לקחת 5–10 ימי עסקים. צוות ה-IT של איירונמן מספק תמיכה ישירה במהלך שלב הבדיקות, מה שמפחית משמעותית את ההתמודדות הלוך ושוב.
שאלה 5: האם אפשר לשלב שער טורבינה עם מערכת נוכחות קיימת של משאבי אנוש או ERP?
כן. מסלולי RS485 ו-REST API של ה-SDK תומכים שניהם באינטגרציה עם פלטפורמות נוכחות משאבי אנוש ומערכות ERP. תצטרך לוודא של-ERP שלך יש נקודת קצה זמינה ב-API או שהוא תומך בתקשורת סריאלית RS485. הצוות של Ironman יכול לעיין בתיעוד ה-API של המערכת שלך ולייעץ על מסלול האינטגרציה הנכון לפני ההזמנה.
שאלה 6: מה קורה אם חיבור ה-API לשער השערים יורד כאופליין?
שערי סיבוב Ironman עם אחסון אישורים פנימי יכולים להמשיך לפעול במצב לא מקוון — הבקר משתמש בכללי גישה שמורים מקומית לאישור או סירוב כניסה. ברגע שחיבור ה-API מתחדש, השער מסנכרן אוטומטית את יומני האירועים וכל עדכון אישור. גיבוי לא מקוון זה חיוני למתקנים שאינם יכולים לקבל השבתה בשערים בזמן הפסקות רשת.
התחלת האינטגרציה שלך
נתיב האינטגרציה הנכון מתמצה בשלוש אפשרויות: סוג התוכנה שלך (ענן או מקומי), סוג התעודה שלך (קוד QR, RFID, ביומטרי), ואת קנה מידת המתקן שלך. Ironman מספק חבילת SDK מלאה — לוח ממשק, תיעוד פרוטוקול, הפניה ל-API, ודגימות קוד — עם הוראות כניסה מאומתות, בנוסף לתמיכה ישירה ב-IT במהלך הבדיקות.
שוק בקרת הגישה הגלובלי גדל ב 4.08% CAGR, מערכות שערי טורנסטה במרכז פריסות האבטחה הארגונית. קבלת האינטגרציה הנכונה של התוכנה מהיום הראשון מגנה על ההשקעה לטווח ארוך.
בקש את חבילת SDK ואת מפרט הפרויקט שלך על ידי יצירת קשר עם צוות Ironman דרך ה-Ourשערי טורנסטל סיטונאי ודף פרויקט. כלול את דרישת דגם השער שלך, סוג הסמכה, ופלטפורמת תוכנה מטרת — וצפו לתגובה טכנית בתוך 12 שעות פעילות.
