Эндпоинт Inspect
Публичный диагностический endpoint, который возвращает ваш IP клиента и данные обнаружения proxy. Используйте его, чтобы проверить, идет ли ваш исходящий трафик через proxy, перед отправкой запросов через FourA.
Request
GET /inspect
Этот endpoint публичный. API key и заголовок 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 |
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[] | Список IP-адресов proxy между вами и 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 отображается в логах целевого сайта, несмотря на ожидаемую анонимность.
- Убедиться, что резидентский или ротируемый proxy скрывает исходный адрес перед отправкой платных запросов через FourA.
Этот endpoint проверяет ваше подключение к FourA. Он не тестирует собственную proxy-сеть FourA. Чтобы проверить, с какого IP исходит запрос, маршрутизируемый через FourA, используйте эндпоинт Proxy и прочитайте ответ.
Ограничения
- Аутентификация не требуется.
- Действует мягкий публичный rate limit. При отправке более нескольких запросов в секунду с одного IP будет применяться ограничение скорости.
- Ответ отражает только заголовки и IP-адреса. Он не может обнаружить полностью прозрачный элитный proxy, удаляющий все proxy-заголовки.
См. также
- API Endpoints: эндпоинты для аутентифицированных запросов
- Authentication: аутентификация для остальных методов API
- Common Issues: отладка ошибок при выполнении запросов