API Scansione TCP

L'API Scansione TCP analizza un intervallo di indirizzi IPv4 per la connettività TCP e connette automaticamente i dispositivi Android raggiungibili tramite ADB sulla rete. È utile per scoprire e connettere dispositivi Android wireless senza comandi adb connect manuali.

Endpoint

POST /api/v1/device/tcp-scan

Requisiti

Requisito Licenza

Questa API richiede un piano Pro, Team o Business. Il piano Starter non ha accesso.

Corpo della Richiesta

Tutti i campi sono opzionali. Quando omessi, l'app usa l'intervallo IP e la porta configurati nelle Impostazioni.

Campo	Tipo	Obbligatorio	Descrizione
start_ip	string	No	Indirizzo IPv4 iniziale (es. "192.168.1.2"). Default alle impostazioni salvate dell'app.
end_ip	string	No	Indirizzo IPv4 finale (es. "192.168.1.254"). Default alle impostazioni salvate dell'app.
port	integer	No	Porta TCP da scansionare (es. 5555). Default al scan_port salvato (default: 5555).

Vincolo Subnet

La scansione è limitata a una singola subnet /24. Se start_ip e end_ip appartengono a subnet /24 diverse, l'intervallo viene automaticamente troncato a start_ip.x.x.255.

Esempi

Usa Impostazioni dell'App (consigliato)

Invia un body vuoto per usare l'intervallo IP e la porta configurati nell'app:

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

Intervallo IP Personalizzato

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

Risposta

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

Campi della Risposta

Campo	Tipo	Descrizione
data.total	integer	Totale IP che hanno risposto sulla porta TCP
data.success	integer	IP connessi con successo tramite ADB
data.failed	integer	IP che hanno fallito la connessione ADB
data.details	array	Lista risultati per IP
data.details[].ip	string	Indirizzo IP scansionato
data.details[].success	boolean	true se la connessione ADB è riuscita
data.details[].message	string	Output ADB o messaggio di errore

Risposte di Errore

Stato HTTP	Codice	Descrizione
403	403	L'accesso all'API richiede il piano Pro+

Come Funziona

1. Sonda TCP — Ogni IP nell'intervallo viene testato con un timeout di connessione TCP di 1 secondo (in modo concorrente).
2. Connessione ADB — Per ogni IP che risponde, viene tentato adb connect <ip>:<port> (fino a 2 tentativi).
3. Aggregazione Risultati — Tutti i risultati per IP vengono raccolti e restituiti.

Dopo una scansione riuscita, i dispositivi connessi appaiono automaticamente in TikMatrix.