Sesiones

Por defecto, cada solicitud rota a una nueva IP. Cuando necesites la misma IP en varias solicitudes, abre una sesión persistente (sticky session).

Modos

Rotación por solicitud

Envía solicitudes sin el flag sid. Cada solicitud utiliza una IP diferente.

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.9

Sesión persistente

Añade sid-<id> al nombre de usuario. El id es cualquier cadena que elijas; las solicitudes posteriores con el mismo id devuelven la misma IP hasta que expire el TTL o la IP se caiga en origen. ttl-<seconds> es opcional y solo es válido junto con sid; sobrescribe la duración predeterminada (120 segundos, mínimo 1). El generador de endpoints del panel también usa 120 por defecto.

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 \
  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)

Elegir un id de sesión

• Elige algo único por flujo de trabajo (order-42, user-a7f3, checkout-2024-11-21-1).
• Dos ejecuciones independientes que compartan el mismo id al mismo tiempo colisionarán en una sola IP persistente.
• El id es arbitrario; Shifter no lo interpreta. Se utiliza como clave de caché.

Cuándo expira la sesión

• Tras ttl segundos, la asignación se elimina y la siguiente solicitud rota a una nueva IP (se conservan los flags de segmentación).
• Si la IP residencial subyacente se desconecta antes, la sesión termina antes de tiempo y la siguiente solicitud rota.

Combinación con la segmentación geográfica

Las sesiones persistentes respetan tus otros flags. Un id de sesión fija una IP dentro de tu filtro:

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

Todas las solicitudes con el mismo id permanecen en una IP de Los Ángeles durante la duración del TTL.

Precaución

No reutilices un id de sesión entre flujos de trabajo concurrentes. Las solicitudes de distintos scripts recaerán en la misma IP, lo cual se interpreta como comportamiento sospechoso para la mayoría de los sistemas anti-bot.

Siguiente paso

• Segmentación geográfica, reduce el conjunto de IPs antes de fijar una.
• Integraciones, ids de sesión en Scrapy, Puppeteer, Playwright.