Connexion et changement d'IP

Les premières sections concernent Residential. Les adresses fixes se connectent autrement : section dédiée ci-dessous.

Ligne de connexion

La réponse de POST /api/v1/packages/{id}/proxies fournit host, port, username, password.

L’identifiant est une chaîne prête à l’emploi : le ciblage et le mode y sont encodés, vous ne devez pas le construire vous-même.

Le port encode le mode et le protocole, vous ne devez pas le modifier.

residential.ipv.rent:10000:USERNAME:PASSWORD          # navigateurs antidétection, gestionnaires de proxys
http://USERNAME:[email protected]:10000   # curl, requests, Node, Go
socks5://USERNAME:[email protected]:12000

curl -x 'http://USERNAME:[email protected]:10000' https://api.ipify.org

Modes et protocoles

Mode	Comportement
`rotating`	nouvelle adresse à chaque connexion
`sticky`	l’adresse est conservée `ttl_minutes` : 3..1440, 60 par défaut

Le port de chaque paire (mode, protocole) figure dans connection_options de la fiche du forfait :

Mode	HTTP	SOCKS5
`rotating`	9000	11000
`sticky`	10000	12000

Les protocoles de messagerie (SMTP, IMAP, POP3) et UDP ne sont pas pris en charge.

Ciblage

{
  "count": 10,
  "geo": {
    "country": "us",
    "state": "california",
    "city": "los angeles"
  }
}

Les valeurs sont des codes du catalogue géo.

Les niveaux sont facultatifs : sans geo - pool mondial.
state, city et asn exigent country.
En dessous du pays, le ciblage est appliqué dans la mesure du possible : si la région, la ville ou l’opérateur demandé n’a pas d’adresses libres, la sortie se fait depuis un autre emplacement du même pays.

Une valeur hors catalogue, une clé inconnue ou une restriction sans pays - 422 invalid_targeting avec field et value.

Changement d’IP

En mode rotating, l’adresse change d’elle-même.

Chaque ligne sticky a son propre lien rotation_url : un GET sur ce lien libère l’adresse actuelle, la connexion suivante en recevra une autre. Aucune authentification n’est nécessaire.

curl -s https://ipv.rent/r/9f3c1e...

HTTP	`status`	Signification
200	`ok`	adresse libérée
200	`not_in_use`	aucune session active ; la connexion suivante donnera de toute façon une nouvelle adresse
200	`unconfirmed`	demande envoyée, pas de confirmation
404	`not_found`	le lien n’est pas valide
410	`expired`	la ressource du lien a expiré ; ne se produit pas pour les forfaits de trafic
429	`rate_limited`	trop fréquent
503	`error`	le changement d’adresse a échoué

Limites : 20 requêtes par minute par adresse, 120 par forfait, 300 par IP appelante. Impossible de révoquer un seul lien - POST /api/v1/packages/{id}/rotation-secret les annule tous d’un coup.

Adresses fixes

Un forfait IPv4 est une liste d’adresses prête à l’emploi. Inutile de générer des lignes : tout se trouve dans la fiche GET /api/v1/packages/{id}.

Quoi	Où le trouver
adresses	`addresses[].host`
port HTTP	`addresses[].port_http`
port SOCKS5	`addresses[].port_socks`
identifiant et mot de passe	`credentials` - un seul pour toutes les adresses du forfait

198.51.100.11:10010:USERNAME:PASSWORD             # navigateurs antidétection, gestionnaires de proxys
http://USERNAME:[email protected]:10010      # curl, requests, Node, Go
socks5://USERNAME:[email protected]:10011

curl -x 'http://USERNAME:[email protected]:10010' https://api.ipify.org

L’adresse de sortie est l’adresse de la liste elle-même, elle ne change pas pendant toute la durée.
UDP fonctionne via SOCKS5 - pour les jeux, les appels et les services sur QUIC.
Pas de ciblage ni de liens de changement d’IP : le pays et l’emplacement sont choisis à l’achat.
Vous pouvez obtenir de nouvelles adresses par remplacement - toutes les adresses du forfait à la fois, une fois tous les 30 jours.
Les protocoles de messagerie (SMTP, IMAP, POP3) ne sont pas pris en charge.

En cas de problème

Symptôme	Cause
échec d’authentification après la génération d’un ensemble	le mot de passe du forfait a été régénéré
tout a cessé de fonctionner pour tous les workers à la fois	volume épuisé, vérifiez `traffic.left_gb`
adresse hors de la géo demandée	pas d’adresses libres dans l’emplacement demandé, un autre emplacement du même pays a été délivré ; le catalogue géo marque ces pays `pool: thin` - prenez un niveau au-dessus
422 `package_unavailable` lors de la génération d’un ensemble	forfait pas encore délivré (attendez `status: active`), `ttl_minutes` hors de 3..1440, ou mode ou protocole non pris en charge par le forfait
les adresses fixes ne répondent pas juste après l’achat	la délivrance du forfait prend jusqu’à 2 minutes
les adresses fixes ont toutes cessé de répondre à la fois	durée écoulée : `status: expired`, prolongez le forfait
échec d’authentification sur les adresses fixes	le mot de passe a été régénéré, ou le forfait a été prolongé après la fin de la durée et un nouveau mot de passe a été délivré - prenez `credentials` dans la fiche
les anciennes adresses fixes ne fonctionnent pas	les adresses ont été remplacées : `replacement.state: done`, les nouvelles sont dans `addresses`