TCP Tarama API

TCP Tarama API, TCP bağlantısı için bir IPv4 adresi aralığını tarar ve ağdaki ADB üzerinden erişilebilir Android cihazlarını otomatik olarak bağlar. Bu, manuel adb connect komutları olmadan kablosuz Android cihazlarını keşfetmek ve bağlamak için kullanışlıdır.

Endpoint

POST /api/v1/device/tcp-scan

Gereksinimler

Lisans Gereksinimi

Bu API, Pro, Team veya Business planı gerektirir. Starter planının erişimi yoktur.

İstek Gövdesi

Tüm alanlar isteğe bağlıdır. Atlandığında uygulama, Ayarlar'da yapılandırılan IP aralığını ve portu kullanır.

Alan	Tür	Gerekli	Açıklama
start_ip	string	Hayır	Başlangıç IPv4 adresi (örn. "192.168.1.2"). Varsayılan olarak uygulamada saklanan ayarlar.
end_ip	string	Hayır	Bitiş IPv4 adresi (örn. "192.168.1.254"). Varsayılan olarak uygulamada saklanan ayarlar.
port	integer	Hayır	Taranacak TCP portu (örn. 5555). Varsayılan olarak saklanan scan_port (varsayılan: 5555).

Alt Ağ Kısıtlaması

Tarama tek bir /24 alt ağıyla sınırlıdır. start_ip ve end_ip farklı /24 alt ağlarına aitlerse, aralık otomatik olarak start_ip.x.x.255 ile kesilir.

Örnekler

Uygulama Ayarlarını Kullan (önerilen)

Uygulamada yapılandırılan IP aralığını ve portu kullanmak için boş gövde gönderin:

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

Özel IP Aralığı

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

Yanıt

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

Yanıt Alanları

Alan	Tür	Açıklama
data.total	integer	TCP portunda yanıt veren toplam IP sayısı
data.success	integer	ADB üzerinden başarıyla bağlanan IP'ler
data.failed	integer	ADB bağlantısı başarısız olan IP'ler
data.details	array	IP başına sonuç listesi
data.details[].ip	string	Taranan IP adresi
data.details[].success	boolean	ADB bağlantısı başarılıysa true
data.details[].message	string	ADB çıktısı veya hata mesajı

Hata Yanıtları

HTTP Durumu	Kod	Açıklama
403	403	API erişimi Pro+ planı gerektirir

Nasıl Çalışır

1. TCP Probe — Aralıktaki her IP, 1 saniyelik TCP bağlantı zaman aşımıyla test edilir (eş zamanlı).
2. ADB Bağlantısı — Yanıt veren her IP için adb connect <ip>:<port> denenir (en fazla 2 yeniden deneme).
3. Sonuç Toplama — Tüm IP başına sonuçlar toplanır ve döndürülür.

Başarılı bir taramanın ardından bağlı cihazlar TikMatrix'te otomatik olarak görünür.