API Quét TCP

API Quét TCP quét một dải địa chỉ IPv4 để kiểm tra kết nối TCP và tự động kết nối các thiết bị Android có thể truy cập qua ADB trên mạng. Điều này hữu ích để khám phá và kết nối các thiết bị Android không dây mà không cần lệnh adb connect thủ công.

Endpoint

POST /api/v1/device/tcp-scan

Yêu cầu

Yêu cầu Giấy phép

API này yêu cầu gói Pro, Team hoặc Business. Gói Starter không có quyền truy cập.

Body Yêu cầu

Tất cả các trường đều tùy chọn. Khi bị bỏ qua, ứng dụng sử dụng dải IP và cổng được cấu hình trong Cài đặt.

Trường	Kiểu	Bắt buộc	Mô tả
start_ip	string	Không	Địa chỉ IPv4 bắt đầu (ví dụ: "192.168.1.2"). Mặc định theo cài đặt lưu trữ của ứng dụng.
end_ip	string	Không	Địa chỉ IPv4 kết thúc (ví dụ: "192.168.1.254"). Mặc định theo cài đặt lưu trữ của ứng dụng.
port	integer	Không	Cổng TCP để quét (ví dụ: 5555). Mặc định theo scan_port đã lưu (mặc định: 5555).

Giới hạn Subnet

Quét bị giới hạn trong một subnet /24 duy nhất. Nếu start_ip và end_ip thuộc các subnet /24 khác nhau, dải sẽ tự động bị cắt về start_ip.x.x.255.

Ví dụ

Dùng Cài đặt Ứng dụng (khuyến nghị)

Gửi body rỗng để sử dụng dải IP và cổng được cấu hình trong ứng dụng:

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

Dải IP Tùy chỉnh

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
  }'

Phản hồi

{
  "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"
      }
    ]
  }
}

Các Trường Phản hồi

Trường	Kiểu	Mô tả
data.total	integer	Tổng số IP phản hồi trên cổng TCP
data.success	integer	Số IP kết nối thành công qua ADB
data.failed	integer	Số IP kết nối ADB thất bại
data.details	array	Danh sách kết quả theo IP
data.details[].ip	string	Địa chỉ IP được quét
data.details[].success	boolean	true nếu kết nối ADB thành công
data.details[].message	string	Kết quả ADB hoặc thông báo lỗi

Phản hồi Lỗi

Trạng thái HTTP	Mã	Mô tả
403	403	Truy cập API yêu cầu gói Pro+

Cách hoạt động

1. Thăm dò TCP — Mỗi IP trong dải được kiểm tra với thời gian chờ kết nối TCP 1 giây (đồng thời).
2. Kết nối ADB — Với mỗi IP phản hồi, adb connect <ip>:<port> được thực hiện (tối đa 2 lần thử lại).
3. Tổng hợp Kết quả — Tất cả kết quả theo IP được thu thập và trả về.

Sau khi quét thành công, các thiết bị đã kết nối xuất hiện tự động trong TikMatrix.