# Inspect Endpoint

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

클라이언트 IP 및 proxy 감지 세부 정보를 반환하는 공개 진단 endpoint입니다. FourA를 통해 request를 보내기 전에 아웃바운드 트래픽이 proxy를 통과하는지 확인하는 용도로 사용합니다.

## Request

`GET /inspect`

이 endpoint는 공개되어 있습니다. API key나 `X-API-Key` header가 필요하지 않습니다.

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

## 응답

```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 | 클라이언트 측 proxy 헤더가 감지되면 true |
| `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[] | 사용자와 FourA 사이의 proxy IP 목록 (있는 경우) |
| `proxyCount` | number | 체인에서 감지된 proxy 수 (0 = 직접 연결) |
| `via` | string[] | `Via` 헤더의 내용 (있는 경우) |
| `hasPrivateIps` | boolean | 체인에 사설/내부 IP가 나타나면 true |

## Proxy 유형

| 유형 | 의미 |
|------|---------------|
| `transparent` | 실제 IP를 전달하며 자신이 proxy임을 식별함 |
| `anonymous` | 실제 IP를 숨기지만 자신이 proxy임을 식별함 |
| `distorting` | 가짜 클라이언트 IP를 대상에 전송함 |
| `none` | Proxy 헤더가 감지되지 않음: 직접 연결이거나 헤더를 보내지 않는 proxy |

## 사용 시점

- 아웃바운드 트래픽이 예상치 못한 회사 proxy나 터널을 거치지 않는지 확인합니다.
- 익명 상태라고 판단했음에도 대상 사이트 로그에 실제 IP가 나타나는 원인을 디버깅합니다.
- FourA를 통해 유료 요청을 보내기 전에 주거용 또는 회전 proxy가 출발지를 제대로 숨기고 있는지 확인합니다.

이 endpoint는 FourA로의 연결을 검사합니다. FourA 자체 proxy 네트워크를 테스트하지는 않습니다. FourA를 통해 라우팅된 요청이 어느 IP에서 오는지 확인하려면 [Proxy endpoint](https://foura.ai/docs/api/endpoints)를 사용하고 응답을 확인하세요.

## 제한 사항

- 인증이 필요하지 않습니다.
- 넉넉한 공개 rate limit이 적용됩니다. 동일한 IP에서 초당 수 회 이상 호출하면 제한이 적용될 수 있습니다.
- 응답에는 헤더와 IP만 반영됩니다. 모든 proxy 헤더를 제거하는 완벽하게 투명한 엘리트 proxy는 감지할 수 없습니다.

## 관련 항목

- [API Endpoints](https://foura.ai/docs/api/endpoints): 인증된 요청 endpoint
- [Authentication](https://foura.ai/docs/getting-started/authentication): 나머지 API를 인증하는 방법
- [Common Issues](https://foura.ai/docs/troubleshooting/common-issues): 요청 실패 디버깅
