Inspect Endpoint

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

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

최상위 필드

Field	Type	Description
`clientIp`	string	원본 클라이언트 IP (전송된 체인의 가장 왼쪽 주소)
`proxyDetection`	object	proxy 감지 및 익명성 분석
`proxyChain`	object	클라이언트 측 IP 체인 분석
`timestamp`	string	request가 검사된 시간의 ISO 8601 타임스탬프

`proxyDetection`

Field	Type	Description
`isProxy`	boolean	클라이언트 측 proxy header가 감지되면 true
`proxyType`	string	다음 중 하나: `transparent`, `anonymous`, `distorting`, `elite`, `none`
`anonymityLevel`	string	다음 중 하나: `transparent`, `anonymous`, `elite`, `none`
`confidence`	string	감지 신뢰도: `high`, `medium` 또는 `low`
`detectedHeaders`	string[]	proxy를 나타내는 header 이름 (예: `via`, `forwarded`)
`explanation`	string	결과에 대한 일반 텍스트 요약

`proxyChain`

Field	Type	Description
`originalClientIp`	string	최상위 `clientIp`와 동일
`proxyChain`	string[]	사용자와 FourA 사이에 존재하는 proxy IP 목록 (있는 경우)
`proxyCount`	number	체인에서 감지된 proxy 수 (0 = 직접 연결)
`via`	string[]	`Via` header가 존재하는 경우 해당 내용
`hasPrivateIps`	boolean	체인에 사설/내부 IP가 포함되어 있으면 true

Proxy 유형

Type	What it means
`transparent`	실제 IP를 전달하고 스스로를 proxy로 식별함
`anonymous`	실제 IP를 숨기지만 스스로를 proxy로 식별함
`distorting`	대상에 가짜 클라이언트 IP를 전송함
`elite`	proxy header가 없으며 직접 연결처럼 보임
`none`	클라이언트 측 proxy가 감지되지 않음

사용 시점

아웃바운드 트래픽이 예상치 못한 기업용 또는 VPN proxy를 거치지 않는지 확인합니다.
익명 상태라고 생각했음에도 대상 사이트 로그에 실제 IP가 표시되는 이유를 디버깅합니다.
FourA를 통해 유료 request를 보내기 전에 주거용 또는 rotating proxy가 원래의 origin을 마스킹하고 있는지 확인합니다.

이 endpoint는 FourA에 대한 연결을 검사합니다. FourA 자체의 proxy 네트워크를 테스트하지는 않습니다. FourA로 라우팅된 request가 어떤 IP에서 오는지 확인하려면 Proxy endpoint를 사용하고 response를 확인하세요.

제한 사항

인증이 필요하지 않습니다.
넉넉한 수준의 공개 rate limit이 적용됩니다. 동일한 IP에서 초당 몇 번 이상 호출하는 경우 제한(throttling)이 발생할 수 있습니다.
response에는 header와 IP만 반영됩니다. 모든 proxy header를 제거하는 완벽하게 투명한 elite proxy는 감지할 수 없습니다.