Dokumentacja › Referencja API › Endpoint Inspect

Endpoint Inspect

Publiczny endpoint diagnostyczny, który zwraca adres IP klienta i 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. Nie wymaga klucza API ani nagłówka 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 (pierwszy adres po lewej w łańcuchu przekazywania)
proxyDetection object Wykrywanie proxy i analiza anonimowości
proxyChain object Szczegółowy podział łańcucha IP po stronie klienta
timestamp string Znacznik czasu ISO 8601 momentu sprawdzenia żądania

proxyDetection

Pole Typ Opis
isProxy boolean True, jeśli wykryto nagłówki proxy po stronie klienta
proxyType string Jedno z: transparent, anonymous, distorting, none
anonymityLevel string Jedno z: transparent, anonymous, none
confidence string Poziom pewności wykrycia: high, medium lub low
detectedHeaders string[] Nazwy nagłówków wskazujących na proxy (np. via, forwarded)
explanation string Proste podsumowanie wyniku

proxyChain

Pole Typ Opis
originalClientIp string To samo co clientIp najwyższego poziomu
proxyChain string[] Lista adresów IP serwerów proxy między Tobą a FourA, jeśli istnieją
proxyCount number Liczba serwerów proxy wykrytych w łańcuchu (0 = połączenie bezpośrednie)
via string[] Zawartość nagłówka Via, jeśli jest obecny
hasPrivateIps boolean True, jeśli w łańcuchu pojawiają się jakiekolwiek prywatne/wewnętrzne adresy IP

Typy proxy

Typ Znaczenie
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 miejsca docelowego
none Brak nagłówków proxy: połączenie bezpośrednie lub proxy, które ich nie wysyła

Kiedy tego używać

  • Aby upewnić się, że Twój ruch wychodzący nie przechodzi przez nieoczekiwane firmowe proxy lub tunel.
  • Aby zdiagnozować, dlaczego Twój prawdziwy IP pojawia się w logach docelowej witryny, mimo że połączenie miało być anonimowe.
  • Aby sprawdzić, czy residential lub rotacyjne proxy maskuje Twoje źródło, zanim wyślesz płatne żądania przez FourA.

Ten endpoint sprawdza Twoje połączenie z FourA. Nie testuje własnej sieci proxy FourA. Aby sprawdzić, z jakiego IP pochodzi żądanie kierowane przez FourA, użyj endpointa Proxy i odczytaj odpowiedź.

Limity

  • Uwierzytelnianie nie jest wymagane.
  • Obowiązuje elastyczny publiczny rate limit. Jeśli wysyłasz więcej niż kilka żądań na sekundę z tego samego IP, spodziewaj się ograniczenia przepustowości (throttling).
  • Odpowiedź odzwierciedla tylko nagłówki i adresy IP. Nie pozwala wykryć w pełni transparentnego proxy typu elite, które usuwa wszystkie nagłówki proxy.

Powiązane

Aktualizacja: 30 września 2026
← Limity żądań Wyniki żądań →