واجهة برمجة تطبيقات TCP Scan

تقوم واجهة برمجة تطبيقات TCP Scan بفحص نطاق من عناوين IPv4 للتحقق من اتصال TCP وتوصيل أجهزة Android القابلة للوصول تلقائيا عبر ADB على الشبكة. يفيد هذا في اكتشاف وتوصيل أجهزة Android اللاسلكية دون الحاجة إلى أوامر adb connect يدوية.

نقطة النهاية

POST /api/v1/device/tcp-scan

المتطلبات

متطلب الترخيص

تتطلب هذه الواجهة خطة 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	يتطلب الوصول إلى الواجهة خطة Pro+

كيف يعمل

1. مسبار TCP — يتم اختبار كل عنوان IP في النطاق بمهلة اتصال TCP مدتها ثانية واحدة (بشكل متزامن).
2. اتصال ADB — لكل IP يستجيب، تتم محاولة adb connect <ip>:<port> (حتى محاولتين).
3. تجميع النتائج — تُجمع جميع نتائج كل IP وتُعاد.

بعد الفحص الناجح، تظهر الأجهزة المتصلة تلقائيا في TikMatrix.