Sessions
Par défaut, chaque requête effectue une rotation vers une nouvelle IP. Lorsque vous avez besoin de la même IP pour plusieurs requêtes, ouvrez une session persistante.
Rotation par requête
Section intitulée « Rotation par requête »Envoyez des requêtes sans indicateur sid. Chaque requête utilise une IP différente.
curl -x customer-USERNAME-country-us:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/json# 72.14.201.44
curl -x customer-USERNAME-country-us:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/json# 98.207.12.9Session persistante
Section intitulée « Session persistante »Ajoutez sid-<id> au nom d’utilisateur. L’id est une chaîne de caractères que vous choisissez librement ; les requêtes suivantes portant le même id renvoient la même IP jusqu’à l’expiration du TTL ou jusqu’à ce que l’IP se déconnecte en amont. ttl-<seconds> est facultatif et n’est valide qu’accompagné de sid ; il remplace la durée de vie par défaut (120 secondes, minimum 1). Le générateur d’endpoint du panneau utilise également 120 par défaut.
customer-USERNAME-country-us-sid-order42 # default 120s lifetimecustomer-USERNAME-country-us-sid-order42-ttl-600 # custom 10-minute lifetimecurl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/json# 72.14.201.44
curl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/json# 72.14.201.44 (same)Choisir un id de session
Section intitulée « Choisir un id de session »- Choisissez un identifiant unique par workflow (
order-42,user-a7f3,checkout-2024-11-21-1). - Deux exécutions distinctes partageant le même id au même moment entreront en conflit sur une seule IP persistante.
- L’id est arbitraire ; Shifter ne l’analyse pas. Il est utilisé comme clé de cache.
Lorsque la session expire
Section intitulée « Lorsque la session expire »- Après
ttlsecondes, l’association est supprimée et la requête suivante effectue une rotation vers une nouvelle IP (les indicateurs de ciblage sont conservés). - Si l’IP résidentielle sous-jacente se déconnecte plus tôt, la session se termine prématurément et la requête suivante effectue une rotation.
Combiner avec le ciblage géographique
Section intitulée « Combiner avec le ciblage géographique »Les sessions persistantes respectent vos autres indicateurs. Un id de session verrouille une IP au sein de votre filtre :
customer-USERNAME-country-us-city-los_angeles-sid-scrape1 # default 120scustomer-USERNAME-country-us-city-los_angeles-sid-scrape1-ttl-300 # custom 5-minToutes les requêtes portant le même id restent sur une seule IP de Los Angeles pendant toute la durée du TTL.
- Ciblage géographique, restreindre le pool avant l’épinglage.
- Intégrations, ids de session dans Scrapy, Puppeteer, Playwright.