Эндпоинт Inspect

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

Request

GET /inspect

Этот endpoint публичный. Не требуется API key или header 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"
}

Поля верхнего уровня

Поле	Тип	Описание
`clientIp`	string	Исходный IP клиента (самый левый адрес в цепочке пересылки)
`proxyDetection`	object	Обнаружение proxy и анализ анонимности
`proxyChain`	object	Детализация цепочки IP на стороне клиента
`timestamp`	string	Временная метка ISO 8601 момента проверки request

`proxyDetection`

Поле	Тип	Описание
`isProxy`	boolean	True, если были обнаружены proxy-headers на стороне клиента
`proxyType`	string	Одно из значений: `transparent`, `anonymous`, `distorting`, `elite`, `none`
`anonymityLevel`	string	Одно из значений: `transparent`, `anonymous`, `elite`, `none`
`confidence`	string	Достоверность обнаружения: `high`, `medium` или `low`
`detectedHeaders`	string[]	Имена headers, которые указали на наличие proxy (например, `via`, `forwarded`)
`explanation`	string	Краткое описание результата на простом английском языке

`proxyChain`

Поле	Тип	Описание
`originalClientIp`	string	То же, что и `clientIp` на верхнем уровне
`proxyChain`	string[]	Список IP-адресов proxy между вами и FourA, если они есть
`proxyCount`	number	Количество обнаруженных proxy в цепочке (0 = прямое подключение)
`via`	string[]	Содержимое header `Via`, если он присутствует
`hasPrivateIps`	boolean	True, если в цепочке присутствуют приватные или внутренние IP-адреса

Типы Proxy

Тип	Что это значит
`transparent`	Пересылает ваш реальный IP и идентифицирует себя как proxy
`anonymous`	Скрывает ваш реальный IP, но идентифицирует себя как proxy
`distorting`	Отправляет поддельный IP клиента целевому ресурсу
`elite`	Без proxy-headers, выглядит как прямое подключение
`none`	Proxy на стороне клиента не обнаружен

Когда это использовать

Убедиться, что ваш исходящий трафик не проходит через корпоративный или VPN-proxy, о котором вы не знали.
Отладить, почему ваш реальный IP отображается в логах целевого сайта, даже когда вы считали себя анонимным.
Проверить, что резидентный или ротируемый proxy маскирует ваш исходный адрес перед отправкой платных requests через FourA.

Этот endpoint проверяет ваше подключение к FourA. Он не тестирует собственную сеть proxy FourA. Чтобы проверить, с какого IP исходит перенаправленный через FourA request, используйте Proxy endpoint и прочитайте response.

Лимиты

Аутентификация не требуется.
Действует щедрый публичный rate limit. Если вы вызываете его чаще нескольких раз в секунду с одного IP, ожидайте throttling.
Response отражает только headers и IP-адреса. Он не может обнаружить абсолютно прозрачный elite proxy, который удаляет все proxy-headers.

Связанные разделы

API Endpoints: Эндпоинты для аутентифицированных requests
Аутентификация: Как аутентифицировать остальные requests к API
Общие проблемы: Отладка сбоев requests

Обновлено: 29 апреля 2026 г.