Endpoint Inspect
Un endpoint de diagnostic public qui renvoie l'IP de votre client 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 requests via FourA.
Request
GET /inspect
Cet endpoint est public. Pas de clé API, pas de header X-API-Key.
curl https://eu.api.foura.ai/inspect
Response
{
"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 client d'origine (adresse la plus a gauche dans la chaine de transfert) |
proxyDetection |
object | Detection de proxy et analyse de l'anonymat |
proxyChain |
object | Detail de la chaine IP cote client |
timestamp |
string | Horodatage ISO 8601 de l'inspection de la requete |
proxyDetection
| Champ | Type | Description |
|---|---|---|
isProxy |
boolean | True si des headers de proxy cote client ont ete detectes |
proxyType |
string | Valeurs possibles : transparent, anonymous, distorting, none |
anonymityLevel |
string | Valeurs possibles : transparent, anonymous, none |
confidence |
string | Niveau de confiance de la detection : high, medium ou low |
detectedHeaders |
string[] | Noms des headers signalant un proxy (ex. via, forwarded) |
explanation |
string | Resume du resultat en langage clair |
proxyChain
| Champ | Type | Description |
|---|---|---|
originalClientIp |
string | Identique au champ de premier niveau clientIp |
proxyChain |
string[] | Liste des IP de proxy entre vous et FourA, le cas echeant |
proxyCount |
number | Nombre de proxys detectes dans la chaine (0 = direct) |
via |
string[] | Contenu du header Via, si present |
hasPrivateIps |
boolean | True si des IP privees/internes apparaissent dans la chaine |
Types de proxy
| Type | Signification |
|---|---|
transparent |
Transmet votre IP reelle et s'identifie comme un proxy |
anonymous |
Masque votre IP reelle mais s'identifie comme un proxy |
distorting |
Envoie une fausse IP client a la destination |
none |
Aucun header de proxy detecte : connexion directe ou proxy n'en transmettant aucun |
Quand utiliser cet endpoint
- Confirmer que votre trafic sortant ne passe pas par un proxy d'entreprise ou un tunnel inattendu.
- Diagnostiquer pourquoi votre IP reelle apparait dans les logs du site cible alors que vous pensiez etre anonyme.
- Verifier qu'un proxy residentiel ou rotatif masque bien votre origine avant d'envoyer des requetes payantes via FourA.
Cet endpoint inspecte votre connexion vers FourA. Il ne teste pas le reseau de proxys propre a FourA. Pour verifier l'IP d'origine d'une requete routee par FourA, utilisez l'endpoint Proxy et lisez la reponse.
Limites
- Aucune authentification requise.
- Soumis a un rate limit public genereux. Si vous effectuez plus de quelques appels par seconde depuis la meme IP, attendez-vous a un bridage.
- La reponse reflete uniquement les headers et les IP. Elle ne peut pas detecter un proxy d'elite parfaitement transparent qui supprime tous les headers de proxy.
Voir aussi
- Endpoints d'API : Les endpoints de requete authentifies
- Authentification : Comment s'authentifier aupres du reste de l'API
- Problemes frequents : Debugger les echecs de requete