TCP स्कैन API

TCP स्कैन API IPv4 पतों की एक श्रृंखला को TCP कनेक्टिविटी के लिए स्कैन करती है और नेटवर्क पर ADB के माध्यम से पहुंच योग्य Android डिवाइसों को स्वचालित रूप से कनेक्ट करती है। यह मैन्युअल adb connect कमांड के बिना वायरलेस Android डिवाइस खोजने और कनेक्ट करने के लिए उपयोगी है।

एंडपॉइंट

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	TCP पोर्ट पर प्रतिक्रिया देने वाले कुल IP
data.success	integer	ADB के माध्यम से सफलतापूर्वक कनेक्ट किए गए IP
data.failed	integer	ADB कनेक्शन विफल रहे IP
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 को 1-सेकंड TCP कनेक्शन टाइमआउट के साथ परीक्षण किया जाता है (एक साथ)।
2. ADB कनेक्ट — प्रत्येक IP जो प्रतिक्रिया देती है, के लिए adb connect <ip>:<port> का प्रयास किया जाता है (2 पुनः प्रयास तक)।
3. परिणाम एकत्रीकरण — सभी प्रति-IP परिणाम एकत्र किए जाते हैं और वापस किए जाते हैं।

सफल स्कैन के बाद, कनेक्टेड डिवाइस TikMatrix में स्वचालित रूप से दिखाई देते हैं।