Docs
Documentation de l'API proxy et intégration
Connectez n'importe quel client HTTP ou SOCKS5 avec un hôte et un login par réseau, choisissez les localisations et sessions avec des clés dans le nom d'utilisateur, et gérez les forfaits avec l'API REST.
Hôtes et ports
Chaque réseau a un hôte. HTTP et HTTPS partagent le premier port, SOCKS5 utilise le second. Le nom d'utilisateur et le mot de passe proviennent du forfait dans votre tableau de bord et sont les mêmes pour les deux protocoles.
| Réseau | Hôte | HTTP(S) | SOCKS5 |
|---|---|---|---|
| Proxies résidentiels | res.proxyhive.cc | 7000 | 7001 |
| Proxies mobiles | mob.proxyhive.cc | 7100 | 7101 |
| Proxies ISP statiques | isp.proxyhive.cc | 8000 | 8001 |
| Proxies datacenter | dc.proxyhive.cc | 7200 | 7201 |
Les forfaits ISP statiques listent chaque adresse avec son propre port au lieu d'un hôte partagé : connectez-vous à ip:port avec le nom d'utilisateur et le mot de passe du forfait.
Clés de nom d'utilisateur
Les clés sont ajoutées à votre nom d'utilisateur avec des traits d'union et peuvent être combinées dans n'importe quel ordre. Sans clés, un forfait rotatif renvoie une adresse aléatoire dans n'importe quel pays.
| Clé | Fonction | Réseaux |
|---|---|---|
| country-us | Code pays ISO à deux lettres. | Résidentiel, mobile, datacenter |
| state-texas | Un état américain ou région de premier niveau. | Résidentiel |
| city-new_york | Une ville, en minuscules, espaces remplacés par des underscores. | Résidentiel, mobile |
| carrier-tmobile | Un opérateur mobile, en minuscules, sans espaces. | Mobile |
| session-a1b2c3 | Garde une IP pour la session, 6 à 10 lettres ou chiffres. | Résidentiel, mobile, datacenter |
| ttl-30 | Minutes pendant lesquelles une session garde son IP, 1 à 1,440. Par défaut 10. | Résidentiel, mobile, datacenter |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
Exemples de code
Remplacez USER et PASS par le login de votre forfait. Les exemples envoient une requête via la passerelle et affichent la réponse.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
API REST
Adresse de base https://proxyhive.cc/api/v1. Les réponses sont en JSON et contiennent toujours ok. Les endpoints publics n'ont pas besoin de clé ; les endpoints de compte nécessitent l'en-tête Authorization: Bearer avec la clé API de votre page de compte.
| Méthode | Chemin | Fonction | Clé |
|---|---|---|---|
| GET | /plans | Tous les forfaits avec id, produit, taille, taux et prix. | Non |
| GET | /locations | Pays avec tailles de pool, villes et opérateurs. | Non |
| GET | /balance | Votre crédit en USD. | Oui |
| POST | /orders | Acheter un forfait : id de forfait et pays (ou n'importe lequel). | Oui |
| GET | /orders | Vos forfaits avec logins, trafic restant et expiration. | Oui |
| GET | /orders/{id} | Un forfait par son code. | Oui |
curl -X POST https://proxyhive.cc/api/v1/orders \
-H "Authorization: Bearer phk_..." \
-H "Content-Type: application/json" \
-d '{"plan": "res-100", "country": "any"}'{
"ok": true,
"order": {
"id": "HO-7K2M9QXR4T",
"product": "resi",
"plan": "res-100",
"quantity": 100,
"unit": "GB",
"status": "active",
"gateway": { "host": "res.proxyhive.cc", "http_port": 7000, "socks5_port": 7001, "username": "...", "password": "..." }
}
}Erreurs et limites
Les appels échoués répondent ok: false avec un code d'erreur et un message : unauthorized (401), bad_plan ou bad_country (400), funds (402, avec le montant manquant), network (503, rien n'a été facturé) et rate_limited (429). Chaque clé API peut envoyer 300 requêtes par minute.
Commencez avec ProxyHive
Créez un compte en quelques secondes, ajoutez du crédit avec de la crypto et copiez votre première connexion proxy. Chaque plan commence à $30.