Inspectエンドポイント

クライアントIPとproxy検出の詳細を返す公開用の診断用endpointです。FourA経由でrequestの送信を開始する前に、アウトバウンドトラフィックがproxyを経由しているかどうかを確認するために使用します。

リクエスト

GET /inspect

このendpointは公開されています。APIキーやX-API-Keyheaderは不要です。

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	requestが検査された時間のISO 8601タイムスタンプ

`proxyDetection`

フィールド	型	説明
`isProxy`	boolean	クライアント側のproxy headerが検出された場合はtrue
`proxyType`	string	次のいずれか: `transparent`、`anonymous`、`distorting`、`elite`、`none`
`anonymityLevel`	string	次のいずれか: `transparent`、`anonymous`、`elite`、`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を送信する
`elite`	proxy headerがなく、直接接続のように見える
`none`	クライアント側のproxyは検出されなかった

使用するタイミング

意図しない企業プロキシやVPN proxyをアウトバウンドトラフィックが通過していないか確認する。
匿名化されていると思っていたにもかかわらず、ターゲットサイトのログに実際のIPが表示される原因をデバッグする。
FourA経由で有料のrequestを送信する前に、レジデンシャルproxyまたはローテーティングproxyがオリジンをマスクしているか検証する。

このendpointは、FourAへの接続を検査します。FourA自体のproxyネットワークをテストするものではありません。FourA経由でルーティングされたrequestがどのIPから送信されているかを確認するには、Proxy endpointを使用し、そのレスポンスを確認してください。

制限事項

認証は不要です。
十分な余裕のある公開rate limitが適用されます。同一IPから1秒間に複数回呼び出すと、スロットリングが発生する可能性があります。
レスポンスにはheaderとIPのみが反映されます。すべてのproxy headerを削除する、完全に透過的なelite proxyを検出することはできません。