ממשק API לסריקת TCP

ממשק ה-API לסריקת TCP סורק טווח של כתובות IPv4 לזיהוי קישוריות TCP ומחבר אוטומטית מכשירי Android נגישים דרך ADB ברשת. פעולה זו שימושית לגילוי וחיבור מכשירי Android אלחוטיים ללא פקודות adb connect ידניות.

נקודת קצה

POST /api/v1/device/tcp-scan

דרישות

דרישת רישיון

ממשק API זה דורש תוכנית Pro, Team או Business. לתוכנית Starter אין גישה.

גוף הבקשה

כל השדות הם אופציונליים. כאשר הם מושמטים, האפליקציה משתמשת בטווח ה-IP והפורט המוגדרים בהגדרות.

שדה	סוג	נדרש	תיאור
start_ip	string	לא	כתובת IPv4 התחלתית (למשל "192.168.1.2"). ברירת מחדל: הגדרות האפליקציה.
end_ip	string	לא	כתובת IPv4 סופית (למשל "192.168.1.254"). ברירת מחדל: הגדרות האפליקציה.
port	integer	לא	פורט TCP לסריקה (למשל 5555). ברירת מחדל: scan_port שמור (ברירת מחדל: 5555).

מגבלת רשת משנה

הסריקה מוגבלת לרשת משנה אחת מסוג /24. אם start_ip ו-end_ip שייכות לרשתות משנה /24 שונות, הטווח מקוצר אוטומטית ל-start_ip.x.x.255.

דוגמאות

שימוש בהגדרות האפליקציה (מומלץ)

שלח גוף ריק כדי להשתמש בטווח ה-IP והפורט המוגדרים באפליקציה:

curl -X POST http://localhost:50809/api/v1/device/tcp-scan \
  -H "Content-Type: application/json" \
  -d '{}'

טווח IP מותאם אישית

curl -X POST http://localhost:50809/api/v1/device/tcp-scan \
  -H "Content-Type: application/json" \
  -d '{
    "start_ip": "192.168.1.2",
    "end_ip": "192.168.1.254",
    "port": 5555
  }'

תגובה

{
  "code": 0,
  "message": "success",
  "data": {
    "total": 3,
    "success": 2,
    "failed": 1,
    "details": [
      {
        "ip": "192.168.1.100",
        "success": true,
        "message": "already connected to 192.168.1.100:5555"
      },
      {
        "ip": "192.168.1.101",
        "success": true,
        "message": "connected to 192.168.1.101:5555"
      },
      {
        "ip": "192.168.1.102",
        "success": false,
        "message": "failed to connect to 192.168.1.102:5555"
      }
    ]
  }
}

שדות התגובה

שדה	סוג	תיאור
data.total	integer	סך כתובות ה-IP שהגיבו על פורט ה-TCP
data.success	integer	כתובות IP שחוברו בהצלחה דרך ADB
data.failed	integer	כתובות IP שחיבורן ה-ADB נכשל
data.details	array	רשימת תוצאות לכל IP
data.details[].ip	string	כתובת ה-IP שנסרקה
data.details[].success	boolean	true אם חיבור ה-ADB הצליח
data.details[].message	string	פלט ADB או הודעת שגיאה

תגובות שגיאה

סטטוס HTTP	קוד	תיאור
403	403	גישה ל-API דורשת תוכנית Pro+

כיצד זה עובד

1. בדיקת TCP — כל IP בטווח נבדק עם פסק זמן של שנייה אחת לחיבור TCP (בו-זמנית).
2. חיבור ADB — לכל IP שמגיב, מנסים adb connect <ip>:<port> (עד 2 ניסיונות חוזרים).
3. אגירת תוצאות — כל תוצאות ה-IP נאספות ומוחזרות.

לאחר סריקה מוצלחת, מכשירים מחוברים מופיעים אוטומטית ב-TikMatrix.