Endpoint Inspect

Un endpoint de diagnostic public qui renvoie votre IP cliente et les détails de détection de proxy. Utilisez-le pour vérifier si votre trafic sortant passe par un proxy avant de commencer à envoyer des requêtes via FourA.

Requête

GET /inspect

Cet endpoint est public. Pas de clé API, pas de header X-API-Key.

curl https://eu.api.foura.ai/inspect

Réponse

{
  "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"
}

Champs de premier niveau

Champ	Type	Description
`clientIp`	string	IP cliente d'origine (adresse la plus à gauche dans la chaîne de transfert)
`proxyDetection`	object	Détection de proxy et analyse d'anonymat
`proxyChain`	object	Analyse de la chaîne d'IP côté client
`timestamp`	string	Horodatage ISO 8601 du moment où la requête a été inspectée

`proxyDetection`

Champ	Type	Description
`isProxy`	boolean	True si des headers de proxy côté client ont été détectés
`proxyType`	string	L'un des suivants : `transparent`, `anonymous`, `distorting`, `elite`, `none`
`anonymityLevel`	string	L'un des suivants : `transparent`, `anonymous`, `elite`, `none`
`confidence`	string	Confiance de détection : `high`, `medium` ou `low`
`detectedHeaders`	string[]	Noms des headers ayant signalé un proxy (par ex. `via`, `forwarded`)
`explanation`	string	Résumé en anglais simple du résultat

`proxyChain`

Champ	Type	Description
`originalClientIp`	string	Identique au `clientIp` de premier niveau
`proxyChain`	string[]	Liste des IP de proxy entre vous et FourA, le cas échéant
`proxyCount`	number	Nombre de proxys détectés dans la chaîne (0 = direct)
`via`	string[]	Contenu du header `Via`, si présent
`hasPrivateIps`	boolean	True si des IP privées ou internes apparaissent dans la chaîne

Types de proxy

Type	Signification
`transparent`	Transmet votre IP réelle et s'identifie comme un proxy
`anonymous`	Masque votre IP réelle mais s'identifie comme un proxy
`distorting`	Envoie une fausse IP cliente à la destination
`elite`	Aucun header de proxy, ressemble à une connexion directe
`none`	Aucun proxy côté client détecté

Quand l'utiliser

Confirmer que votre trafic sortant ne passe pas par un proxy d'entreprise ou un VPN inattendu.
Déboguer pourquoi votre IP réelle apparaît dans les logs du site cible alors que vous pensiez être anonyme.
Vérifier qu'un proxy résidentiel ou rotatif masque bien votre origine avant d'envoyer des requêtes payantes via FourA.

Cet endpoint inspecte votre connexion à FourA. Il ne teste pas le propre réseau de proxys de FourA. Pour vérifier de quelle IP provient une requête acheminée par FourA, utilisez l' endpoint Proxy et lisez la réponse.

Limites

Aucune authentification requise.
Soumis à un rate limit public généreux. Si vous l'appelez plus de quelques fois par seconde depuis la même IP, attendez-vous à une limitation.
La réponse ne reflète que les headers et les IP. Elle ne peut pas détecter un proxy elite parfaitement transparent qui supprime tous les headers de proxy.

Liens utiles

API Endpoints : Les endpoints de requête authentifiée
Authentication : Comment authentifier le reste de l'API
Common Issues : Déboguer les échecs de requête

Mis à jour : 29 avril 2026