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.

Modes

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 \
  http://ip-info.com/json
# 72.14.201.44

curl -x customer-USERNAME-country-us:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 98.207.12.9

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 lifetime
customer-USERNAME-country-us-sid-order42-ttl-600     # custom 10-minute lifetime

curl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44

curl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44  (same)

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

• Après ttl secondes, 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

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 120s
customer-USERNAME-country-us-city-los_angeles-sid-scrape1-ttl-300    # custom 5-min

Toutes les requêtes portant le même id restent sur une seule IP de Los Angeles pendant toute la durée du TTL.

Attention

Ne réutilisez pas un id de session entre des workflows concurrents. Les requêtes provenant de scripts différents aboutiront sur la même IP, ce qui apparaît comme un comportement suspect pour la plupart des systèmes anti-bot.

Sessions entre machines et régions

Les sessions persistantes sont conservées par région. p.shifter.io connecte chaque machine à sa région la plus proche : le même sid utilisé depuis deux machines qui arrivent dans des régions différentes obtient donc deux IP différentes. Cela concerne :

• Un scraper et un solveur de captcha qui utilisent tous deux la session (le solveur se connecte depuis ses propres serveurs).
• Plusieurs serveurs, conteneurs ou fonctions cloud qui partagent une session.
• Un navigateur et un client API distinct qui doivent apparaître comme le même visiteur.

Pour garder une seule IP partout, pointez chaque outil qui partage la session vers le même point d’entrée régional, par exemple fra.p.shifter.io :

customer-USERNAME-country-us-sid-order42-ttl-600:PASSWORD@fra.p.shifter.io:443

Une seule machine qui se connecte toujours via p.shifter.io n’est généralement pas concernée.

Suite

• Ciblage géographique, restreindre le pool avant l’épinglage.
• Intégrations, ids de session dans Scrapy, Puppeteer, Playwright.