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

응답

{
  "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를 사용하고 응답을 확인하세요.

제한 사항

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