# Эндпоинт Inspect

> URL: https://foura.ai/ru/docs/api/inspect
> Updated: 2026-09-30
> Index: https://foura.ai/llms.txt

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

## Request

`GET /inspect`

Этот endpoint публичный. API key и заголовок `X-API-Key` не требуются.

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

## Response

```json
{
  "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](https://foura.ai/docs/api/endpoints) и прочитайте ответ.

## Ограничения

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

## См. также

- [API Endpoints](https://foura.ai/docs/api/endpoints): эндпоинты для аутентифицированных запросов
- [Authentication](https://foura.ai/docs/getting-started/authentication): аутентификация для остальных методов API
- [Common Issues](https://foura.ai/docs/troubleshooting/common-issues): отладка ошибок при выполнении запросов
