API d’analyse
Un site répond-il depuis notre serveur ? Est-il bloqué par pays ou protégé contre les robots ? Et son adresse relayée.
Gratuit
100
analyses par jour et par IP, sans clé
Requête
$ curl "proxy-on.site/api/check?url=bbc.com"
$ curl -H "Authorization: Bearer pk_…" "proxy-on.site/api/check?url=bbc.com" # Pro
La clé passe aussi par l’en-tête X-Api-Key ou le paramètre ?key=. Gardez-la secrète (côté serveur).
Réponse
{
"url": "https://www.bbc.com/",
"final": "https://www.bbc.com/",
"host": "www.bbc.com",
"status": "ok",
"http": 200,
"ms": 142,
"title": "BBC - Home",
"relay": "https://proxy-on.site/go/aHR0cHM6Ly93d3cuYmJjLmNvbS8"
}
| status | Signification |
|---|---|
| ok | Le site répond |
| dns | Nom de domaine introuvable |
| timeout | Pas de réponse |
| down | Injoignable |
| geo | Bloqué dans le pays du serveur |
| challenge | Protection anti-robot |
| error | Erreur 5xx du site |
| denied | Accès refusé (4xx) |
| pro | Site réservé à Pro (adultes, jeux d’argent) : relay vaut null |
| refused | Site non autorisé sur Proxy-On |
Erreurs
| Code | Réponse | Signification |
|---|---|---|
| 401 | {"error":"invalid_key"} | Clé inconnue ou désactivée |
| 422 | {"error":"invalid_url"} | Adresse invalide |
| 429 | {"error":"quota"} | Quota du jour atteint (remis à zéro chaque jour à minuit) |
| 429 | {"error":"rate_limited"} | Trop de requêtes en une minute |