# Inspect Endpoint

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

一个公共诊断 endpoint，用于返回您的客户端 IP 及 proxy 检测详情。在开始通过 FourA 发送 request 之前，可使用它来验证出站流量是否经过 proxy。

## Request

`GET /inspect`

此 endpoint 为公开接口。无需 API key，无需 `X-API-Key` header。

```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 | 检测 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](https://foura.ai/docs/api/endpoints) 并查看 response。

## 限制

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

## 相关内容

- [API Endpoints](https://foura.ai/docs/api/endpoints)：需认证的 request endpoint
- [Authentication](https://foura.ai/docs/getting-started/authentication)：其余 API 的认证方式
- [Common Issues](https://foura.ai/docs/troubleshooting/common-issues)：排查 request 失败问题
