Inspect Endpoint

一个公共诊断 endpoint，用于返回您的客户端 IP 及 proxy 检测详情。在开始通过 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"
}

顶层字段

字段	类型	说明
`clientIp`	string	原始客户端 IP（转发链中最左侧的地址）
`proxyDetection`	object	proxy 检测与匿名性分析
`proxyChain`	object	客户端 IP 链拆解
`timestamp`	string	检测 request 时的 ISO 8601 时间戳

`proxyDetection`

字段	类型	说明
`isProxy`	boolean	若检测到客户端 proxy header 则为 true
`proxyType`	string	取值之一：`transparent`、`anonymous`、`distorting`、`none`
`anonymityLevel`	string	取值之一：`transparent`、`anonymous`、`none`
`confidence`	string	检测置信度：`high`、`medium` 或 `low`
`detectedHeaders`	string[]	标明存在 proxy 的 header 名称（例如 `via`、`forwarded`）
`explanation`	string	结果的纯文本简述

`proxyChain`

字段	类型	说明
`originalClientIp`	string	与顶层 `clientIp` 相同
`proxyChain`	string[]	您与 FourA 之间的 proxy IP 列表（若有）
`proxyCount`	number	链中检测到的 proxy 数量（0 = 直连）
`via`	string[]	`Via` header 的内容（若存在）
`hasPrivateIps`	boolean	若链中出现任何私有/内网 IP 则为 true

Proxy 类型

类型	含义
`transparent`	转发您的真实 IP 并表明自身为 proxy
`anonymous`	隐藏您的真实 IP 但表明自身为 proxy
`distorting`	向目标发送伪造的客户端 IP
`none`	未发现 proxy header：直连连接，或未发送任何 header 的 proxy

适用场景

确认您的出站流量未经过非预期的企业 proxy 或隧道。
排查在自认匿名的状态下真实 IP 仍出现在目标网站日志中的原因。
在通过 FourA 发送付费 request 前，验证住宅或轮换 proxy 是否已隐藏您的源 IP。

此 endpoint 仅检测您与 FourA 的连接，不用于测试 FourA 本身的 proxy 网络。如需验证经 FourA 路由的 request 来自哪个 IP，请使用 Proxy endpoint 并查看 response。

限制

无需认证。
受宽松的公开 rate limit 限制。如果来自同一 IP 的请求频率超过每秒数次，将被限流。
response 仅反映 header 和 IP。无法检测完全剥离所有 proxy header 的全透明高匿 proxy。