TCP-skannings-API

TCP-skannings-API:et skannar ett intervall av IPv4-adresser för TCP-anslutning och ansluter automatiskt nåbara Android-enheter via ADB i nätverket. Detta är användbart för att upptäcka och ansluta trådlösa Android-enheter utan manuella adb connect-kommandon.

Endpoint

POST /api/v1/device/tcp-scan

Krav

Licenskrav

Detta API kräver en Pro-, Team- eller Business-plan. Starter-planen har inte tillgång.

Begäransbody

Alla fält är valfria. När de utelämnas använder appen IP-intervallet och porten som konfigurerats i Inställningar.

Fält	Typ	Obligatoriskt	Beskrivning
start_ip	string	Nej	Start-IPv4-adress (t.ex. "192.168.1.2"). Standard är appens sparade inställningar.
end_ip	string	Nej	Slut-IPv4-adress (t.ex. "192.168.1.254"). Standard är appens sparade inställningar.
port	integer	Nej	TCP-port att skanna (t.ex. 5555). Standard är sparat scan_port (standard: 5555).

Subnätbegränsning

Skanningen är begränsad till ett enskilt /24-subnät. Om start_ip och end_ip tillhör olika /24-subnät trunkeras intervallet automatiskt till start_ip.x.x.255.

Exempel

Använd appinställningar (rekommenderas)

Skicka en tom body för att använda IP-intervallet och porten som konfigurerats i appen:

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

Anpassat IP-intervall

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

Svar

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

Svarsfält

Fält	Typ	Beskrivning
data.total	integer	Totalt antal IP som svarade på TCP-porten
data.success	integer	IP som anslöts via ADB
data.failed	integer	IP vars ADB-anslutning misslyckades
data.details	array	Resultatlista per IP
data.details[].ip	string	Skannad IP-adress
data.details[].success	boolean	true om ADB-anslutningen lyckades
data.details[].message	string	ADB-utdata eller felmeddelande

Felsvar

HTTP-status	Kod	Beskrivning
403	403	API-åtkomst kräver Pro+-plan

Hur det fungerar

1. TCP-sond — Varje IP i intervallet testas med en 1-sekunds TCP-anslutningstimeout (parallellt).
2. ADB-anslutning — För varje IP som svarar försöks adb connect <ip>:<port> (upp till 2 försök).
3. Resultatsammanställning — Alla resultat per IP samlas in och returneras.

Efter en lyckad skanning visas anslutna enheter automatiskt i TikMatrix.