Aller au contenu
ProxyHub
Connexion

Pour les développeurs

API ProxyHub

Tout ce que vous faites dans l'espace client, vous pouvez le faire depuis vos scripts : liste des proxys avec identifiants et IP actuelle, changement d'IP, renouvellement depuis le solde, protocole et rotation automatique. Réponses JSON, rien à installer.

La clé

Créez la clé dans Réglages → API de l'espace client (jusqu'à 5 par compte) et envoyez-la à chaque requête dans l'en-tête Authorization. La clé vaut pour tous vos proxys : traitez-la comme un mot de passe.

curl https://app.proxyhub.it/api/v1/proxies \
  -H "Authorization: Bearer ph_XXXXXXXXXXXXXXXXXXXXXXXX"

Adresse de base

https://app.proxyhub.it/api/v1

Endpoints

GET/proxies

Tous vos proxys, avec identifiants, IP actuelle, état et expiration.

GET/proxies/{port}

Un proxy.

PATCH/proxies/{port}

Change le protocole (http ou socks5), l'utilisateur, le mot de passe ou la rotation automatique (minutes : 5, 10, 15, 30, 60, 180, 360, 720, 1440, ou null pour la désactiver). N'envoyez que les champs à changer.

curl -X PATCH https://app.proxyhub.it/api/v1/proxies/41170 \
  -H "Authorization: Bearer ph_…" \
  -H "Content-Type: application/json" \
  -d '{"protocol": "socks5", "auto_rotate_minutes": 30}'

POST/proxies/{port}/rotate

Nouvelle IP. Répond avec la nouvelle IP.

POST/proxies/{port}/renew

Renouvelle en payant depuis le solde : plan vaut daily, weekly ou monthly (trial seulement pour un proxy d'essai) ; coupon facultatif.

curl -X POST https://app.proxyhub.it/api/v1/proxies/41170/renew \
  -H "Authorization: Bearer ph_…" \
  -H "Content-Type: application/json" \
  -d '{"plan": "monthly"}'

GET/balance

Solde en dollars.

Exemple de réponse

{
  "proxies": [
    {
      "port": 41170,
      "host": "sfeshg.com",
      "protocol": "http",
      "username": "ph_e12734",
      "password": "••••••••••",
      "url": "http://ph_e12734:••••••••••@sfeshg.com:41170",
      "status": "active",
      "online": true,
      "ip": "151.19.150.182",
      "country": "it",
      "carrier": "WindTre",
      "plan": "monthly",
      "expires_at": "2026-11-05T09:48:33.221Z",
      "auto_renew": false,
      "auto_rotate_minutes": null,
      "rotation_url": "https://sfeshg.com/r/…",
      "traffic_bytes": 1834021993,
      "created_at": "2026-10-05T09:48:33.221Z"
    }
  ]
}

Limites

  • 120 requêtes par minute et par compte.
  • Changement d'IP : au plus un toutes les 2 minutes par téléphone (le bouton et le lien de rotation comptent aussi).
  • Renouvellements : 10 par minute.

Erreurs

Les erreurs ont toujours cette forme, avec un code stable et un message lisible :

{"error": "too_soon", "message": "The IP was changed less than 2 minutes ago. Wait and retry."}
401 unauthorizedclé absente, inconnue ou révoquée
404 not_foundaucun proxy avec ce port sur votre compte
400 invalidparamètres incorrects (le message précise lesquels)
402 insufficient_balancesolde insuffisant pour le renouvellement
403 expiredproxy expiré ou bloqué : renouvelez-le d'abord
429 too_soonIP changée il y a moins de 2 minutes
429 rate_limitedtrop de requêtes
502 backendle serveur des proxys n'a pas répondu : réessayez sous peu

Sans clé : le lien de rotation

Pour le seul changement d'IP, pas besoin de clé : chaque proxy a un lien de rotation dans sa fiche, à ouvrir ou appeler depuis vos scripts.

Depuis le téléphone : le bot Telegram

Associez Telegram depuis le Profil et utilisez /proxy, /ip, /rotate <port> et /balance dans la discussion avec le bot.

Créer votre clé