Inspect Endpoint

Публичен диагностичен endpoint, който връща вашия клиентски IP адрес и детайли за засичане на proxy. Използвайте го, за да проверите дали изходящият ви трафик минава през proxy, преди да започнете да изпращате requests през FourA.

Request

GET /inspect

Този endpoint е публичен. Без API key, без X-API-Key header.

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

Полета от първо ниво

Поле Тип Описание
clientIp string Оригинален клиентски IP адрес (най-левият адрес във веригата за препращане)
proxyDetection object Засичане на proxy и анализ на анонимността
proxyChain object Разбивка на IP веригата от страна на клиента
timestamp string ISO 8601 времево клеймо за момента на инспектиране на заявката

proxyDetection

Поле Тип Описание
isProxy boolean True, ако са открити клиентски proxy заглавки
proxyType string Едно от: transparent, anonymous, distorting, none
anonymityLevel string Едно от: transparent, anonymous, none
confidence string Увереност на засичането: high, medium или low
detectedHeaders string[] Имена на заглавки, сигнализиращи за proxy (напр. via, forwarded)
explanation string Обобщение на резултата на ясен език

proxyChain

Поле Тип Описание
originalClientIp string Същото като clientIp от първо ниво
proxyChain string[] Списък с proxy IP адреси между вас и FourA, ако има такива
proxyCount number Брой засечени proxy сървъри във веригата (0 = директна връзка)
via string[] Съдържание на заглавката Via, ако присъства
hasPrivateIps boolean True, ако във веригата присъстват частни/вътрешни IP адреси

Типове proxy

Тип Значение
transparent Препраща реалния ви IP адрес и се идентифицира като proxy
anonymous Скрива реалния ви IP адрес, но се идентифицира като proxy
distorting Изпраща фалшив клиентски IP адрес към дестинацията
none Няма открити proxy заглавки: директна връзка или proxy, което не изпраща такива

Кога да използвате това

  • За да потвърдите, че изходящият ви трафик не преминава през неочакван корпоративен proxy сървър или тунел.
  • За да дебъгнете защо реалният ви IP адрес се появява в логовете на целевия сайт, дори когато смятате, че сте анонимни.
  • За да проверите дали дадено residential или rotating proxy маскира вашия произход, преди да изпращате платени заявки през FourA.

Този endpoint инспектира връзката ви към FourA. Той не тества собствената proxy мрежа на FourA. За да проверите от кой IP адрес идва заявка, маршрутизирана през FourA, използвайте Proxy endpoint и прочетете отговора.

Ограничения

  • Не се изисква автентикация.
  • Прилага се щедър публичен rate limit. Ако правите повече от няколко заявки в секунда от един и същ IP адрес, очаквайте throttling.
  • Отговорът отразява само заглавките и IP адресите. Той не може да засече напълно прозрачно елитно proxy, което премахва всички proxy заглавки.

Свързани

  • API Endpoints: Endpoint-и за автентикирани заявки
  • Authentication: Как да се автентикирате за останалата част от API
  • Common Issues: Дебъгване на грешки при заявки
Обновено: 30 септември 2026 г.