# Inspectエンドポイント

> URL: https://foura.ai/ja/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 | プロキシ検出および匿名性分析 |
| `proxyChain` | object | クライアント側IPチェーンの内訳 |
| `timestamp` | string | リクエストが検査された日時のISO 8601タイムスタンプ |

### `proxyDetection`

| フィールド | タイプ | 説明 |
|-------|------|-------------|
| `isProxy` | boolean | クライアント側プロキシヘッダーが検出された場合はtrue |
| `proxyType` | string | 次のいずれか: `transparent`, `anonymous`, `distorting`, `none` |
| `anonymityLevel` | string | 次のいずれか: `transparent`, `anonymous`, `none` |
| `confidence` | string | 検出の信頼度: `high`, `medium`, または `low` |
| `detectedHeaders` | string[] | プロキシを示したヘッダー名（例: `via`, `forwarded`） |
| `explanation` | string | 結果の概要テキスト |

### `proxyChain`

| フィールド | タイプ | 説明 |
|-------|------|-------------|
| `originalClientIp` | string | トップレベルの `clientIp` と同一 |
| `proxyChain` | string[] | 送信元とFourAの間にあるプロキシIPのリスト（存在する場合） |
| `proxyCount` | number | チェーン内で検出されたプロキシの数（0 = 直接接続） |
| `via` | string[] | `Via` ヘッダーの内容（存在する場合） |
| `hasPrivateIps` | boolean | チェーン内にプライベート/内部IPが含まれている場合はtrue |

## プロキシタイプ

| タイプ | 意味 |
|------|---------------|
| `transparent` | 実際のIPを転送し、自身がプロキシであることを示す |
| `anonymous` | 実際のIPを隠すが、自身がプロキシであることを示す |
| `distorting` | 宛先に偽のクライアントIPを送信する |
| `none` | プロキシヘッダーが検出されない: 直接接続、またはヘッダーを送信しないプロキシ |

## 主な用途

- 送信トラフィックが意図しない企業プロキシやトンネルを経由していないか確認する。
- 匿名化されているはずのリクエストで、実際のIPがターゲットサイトのログに記録される原因をデバッグする。
- FourA経由で有料リクエストを送信する前に、レジデンシャルまたはローテーティングプロキシが送信元を隠蔽しているか検証する。

このendpointはFourAへの接続を検査します。FourA自体のプロキシネットワークをテストするものではありません。FourA経由のリクエストがどのIPから送信されているかを確認するには、[Proxy endpoint](https://foura.ai/docs/api/endpoints)を使用してレスポンスを確認してください。

## 制限事項

- 認証は不要です。
- 余裕のあるパブリックrate limitが適用されます。同じIPから毎秒複数回呼び出すと、スロットリングが発生する場合があります。
- レスポンスにはヘッダーとIPのみが反映されます。すべてのプロキシヘッダーを削除する完全なエリートプロキシは検出できません。

## 関連リンク

- [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): リクエストエラーのデバッグ
