TCP Scan API

De TCP Scan API scant een reeks IPv4-adressen op TCP-connectiviteit en verbindt bereikbare Android-apparaten automatisch via ADB op het netwerk. Dit is handig voor het ontdekken en verbinden van draadloze Android-apparaten zonder handmatige adb connect-opdrachten.

Endpoint

POST /api/v1/device/tcp-scan

Vereisten

Licentievereiste

Deze API vereist een Pro-, Team- of Business-abonnement. Het Starter-abonnement heeft geen toegang.

Verzoekbody

Alle velden zijn optioneel. Wanneer weggelaten, gebruikt de app het IP-bereik en de poort die zijn geconfigureerd in Instellingen.

Veld	Type	Vereist	Beschrijving
start_ip	string	Nee	Beginadres IPv4 (bijv. "192.168.1.2"). Standaard naar opgeslagen app-instellingen.
end_ip	string	Nee	Eindadres IPv4 (bijv. "192.168.1.254"). Standaard naar opgeslagen app-instellingen.
port	integer	Nee	Te scannen TCP-poort (bijv. 5555). Standaard naar opgeslagen scan_port (standaard: 5555).

Subnet-beperking

De scan is beperkt tot één enkel /24-subnet. Als start_ip en end_ip tot verschillende /24-subnets behoren, wordt het bereik automatisch afgekapt tot start_ip.x.x.255.

Voorbeelden

App-instellingen gebruiken (aanbevolen)

Stuur een lege body om het IP-bereik en de poort te gebruiken die in de app zijn geconfigureerd:

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

Aangepast IP-bereik

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

Antwoord

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

Antwoordvelden

Veld	Type	Beschrijving
data.total	integer	Totaal aantal IP's dat reageerde op de TCP-poort
data.success	integer	IP's die succesvol verbonden zijn via ADB
data.failed	integer	IP's waarbij de ADB-verbinding mislukte
data.details	array	Resultatenlijst per IP
data.details[].ip	string	Gescand IP-adres
data.details[].success	boolean	true als de ADB-verbinding geslaagd is
data.details[].message	string	ADB-uitvoer of foutmelding

Foutantwoorden

HTTP-status	Code	Beschrijving
403	403	API-toegang vereist Pro+-abonnement

Hoe het werkt

1. TCP-sonde — Elk IP in het bereik wordt getest met een TCP-verbindingstimeout van 1 seconde (gelijktijdig).
2. ADB-verbinding — Voor elk IP dat reageert, wordt adb connect <ip>:<port> geprobeerd (maximaal 2 pogingen).
3. Resultaataggregatie — Alle resultaten per IP worden verzameld en geretourneerd.

Na een succesvolle scan verschijnen verbonden apparaten automatisch in TikMatrix.