API Scan TCP

API Scan TCP memindai rentang alamat IPv4 untuk konektivitas TCP dan menghubungkan perangkat Android yang dapat dijangkau secara otomatis melalui ADB di jaringan. Ini berguna untuk menemukan dan menghubungkan perangkat Android nirkabel tanpa perintah adb connect manual.

Endpoint

POST /api/v1/device/tcp-scan

Persyaratan

Persyaratan Lisensi

API ini memerlukan paket Pro, Team, atau Business. Paket Starter tidak memiliki akses.

Body Permintaan

Semua field bersifat opsional. Jika dihilangkan, aplikasi menggunakan rentang IP dan port yang dikonfigurasi di Pengaturan.

Field	Tipe	Wajib	Deskripsi
start_ip	string	Tidak	Alamat IPv4 awal (mis. "192.168.1.2"). Default ke pengaturan aplikasi yang tersimpan.
end_ip	string	Tidak	Alamat IPv4 akhir (mis. "192.168.1.254"). Default ke pengaturan aplikasi yang tersimpan.
port	integer	Tidak	Port TCP yang dipindai (mis. 5555). Default ke scan_port yang tersimpan (default: 5555).

Batasan Subnet

Pemindaian dibatasi pada satu subnet /24. Jika start_ip dan end_ip berada di subnet /24 yang berbeda, rentang dipotong secara otomatis menjadi start_ip.x.x.255.

Contoh

Gunakan Pengaturan Aplikasi (direkomendasikan)

Kirim body kosong untuk menggunakan rentang IP dan port yang dikonfigurasi di aplikasi:

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

Rentang IP Kustom

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

Respons

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

Field Respons

Field	Tipe	Deskripsi
data.total	integer	Total IP yang merespons pada port TCP
data.success	integer	IP yang berhasil terhubung melalui ADB
data.failed	integer	IP yang gagal terhubung melalui ADB
data.details	array	Daftar hasil per IP
data.details[].ip	string	Alamat IP yang dipindai
data.details[].success	boolean	true jika koneksi ADB berhasil
data.details[].message	string	Output ADB atau pesan kesalahan

Respons Error

Status HTTP	Kode	Deskripsi
403	403	Akses API memerlukan paket Pro+

Cara Kerjanya

1. Probe TCP — Setiap IP dalam rentang diuji dengan timeout koneksi TCP 1 detik (secara bersamaan).
2. Koneksi ADB — Untuk setiap IP yang merespons, adb connect <ip>:<port> dicoba (hingga 2 kali percobaan ulang).
3. Agregasi Hasil — Semua hasil per IP dikumpulkan dan dikembalikan.

Setelah pemindaian berhasil, perangkat yang terhubung muncul secara otomatis di TikMatrix.