Inspectエンドポイント

クライアント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	プロキシ検出および匿名性分析
`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を使用してレスポンスを確認してください。

制限事項

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