Dokumentacja › Referencja API › Endpoint Inspect

Endpoint Inspect

Publiczny endpoint diagnostyczny, który zwraca Twój adres IP klienta oraz szczegóły wykrywania proxy. Użyj go, aby sprawdzić, czy Twój ruch wychodzący przechodzi przez proxy, zanim zaczniesz wysyłać requesty przez FourA.

Request

GET /inspect

Ten endpoint jest publiczny. Brak klucza API, brak headera X-API-Key.

curl https://eu.api.foura.ai/inspect

Response

{
  "clientIp": "203.0.113.42",
  "proxyDetection": {
    "isProxy": false,
    "proxyType": "none",
    "anonymityLevel": "none",
    "confidence": "medium",
    "detectedHeaders": [],
    "explanation": "Direct connection (no client-side proxy detected). Note: Elite proxies cannot be ruled out without additional data."
  },
  "proxyChain": {
    "originalClientIp": "203.0.113.42",
    "proxyCount": 0,
    "hasPrivateIps": false
  },
  "timestamp": "2026-04-29T08:07:04.683Z"
}

Pola najwyższego poziomu

Pole Typ Opis
clientIp string Pierwotny IP klienta (najbardziej wysunięty na lewo adres w łańcuchu przekazywania)
proxyDetection object Detekcja proxy i analiza anonimowości
proxyChain object Szczegółowy podział łańcucha IP po stronie klienta
timestamp string Znacznik czasu ISO 8601 momentu sprawdzenia requestu

proxyDetection

Pole Typ Opis
isProxy boolean True, jeśli wykryto headery proxy po stronie klienta
proxyType string Jeden z: transparent, anonymous, distorting, elite, none
anonymityLevel string Jeden z: transparent, anonymous, elite, none
confidence string Wiarygodność detekcji: high, medium lub low
detectedHeaders string[] Nazwy headerów, które wskazały na proxy (np. via, forwarded)
explanation string Podsumowanie wyniku w prostym języku angielskim

proxyChain

Pole Typ Opis
originalClientIp string Taki sam jak clientIp na najwyższym poziomie
proxyChain string[] Lista adresów IP proxy pomiędzy Tobą a FourA, jeśli istnieją
proxyCount number Liczba wykrytych proxy w łańcuchu (0 = bezpośrednie połączenie)
via string[] Zawartość headera Via, jeśli jest obecny
hasPrivateIps boolean True, jeśli w łańcuchu pojawiają się prywatne/wewnętrzne adresy IP

Typy proxy

Typ Co oznacza
transparent Przekazuje Twój prawdziwy IP i identyfikuje się jako proxy
anonymous Ukrywa Twój prawdziwy IP, ale identyfikuje się jako proxy
distorting Wysyła fałszywy IP klienta do celu
elite Brak headerów proxy, wygląda jak bezpośrednie połączenie
none Nie wykryto proxy po stronie klienta

Kiedy tego używać

  • Upewnij się, że Twój ruch wychodzący nie przechodzi przez nieoczekiwane proxy firmowe lub VPN.
  • Zdebuguj, dlaczego Twój prawdziwy IP pojawia się w logach docelowej witryny, nawet gdy wydawało Ci się, że jesteś anonimowy.
  • Zweryfikuj, czy proxy residential lub rotacyjne maskuje Twoje pochodzenie, zanim wyślesz płatne requesty przez FourA.

Ten endpoint bada Twoje połączenie z FourA. Nie testuje on własnej sieci proxy FourA. Aby zweryfikować, z jakiego IP pochodzi request kierowany przez FourA, użyj endpointu Proxy i odczytaj response.

Limity

  • Autoryzacja nie jest wymagana.
  • Obowiązuje hojny publiczny rate limit. Jeśli będziesz wysyłać zapytania częściej niż kilka razy na sekundę z tego samego IP, spodziewaj się ograniczenia przepustowości (throttlingu).
  • Response odzwierciedla tylko headery i adresy IP. Nie wykryje on idealnie transparentnego proxy typu elite, które usuwa wszystkie headery proxy.

Powiązane

Aktualizacja: 29 kwietnia 2026
← Limity żądań Wyniki żądań →