Guía de Integración Rápida
Conectá cualquier cliente HTTP o herramienta de web scraping a los gateways de Sovereign en menos de 5 minutos. Toda la lógica de ruteo, país, sesión y rotación se controla de forma transparente en la cadena del nombre de usuario.
1. Elegí tu lenguaje o entorno
# Forward HTTP / HTTPS CONNECT a través del Gateway Sovereign
curl -x "http://acme-product-residential-mode-sticky-country-us-city-newyork-asn-as7922-session-scraperjob01-sesstime-30:[email protected]:9000" "https://httpbin.org/ip"
# Salida con rotación automática por petición (Backconnect)
curl -x "http://acme-product-residential-mode-rotating-country-us:[email protected]:9000" "https://api.ipify.org"2. Gramática de Parámetros en el Username
En lugar de configurar múltiples endpoints o puertos, Sovereign utiliza una sintaxis compuesta en el nombre de usuario para definir el comportamiento de cada conexión saliente:
| Parámetro | Opciones / Formato | Descripción |
|---|---|---|
| -product-<type> | residential, mobile, isp, datacenter | Tipo de pool de salida deseado. Por defecto: residential. |
| -mode-<mode> | rotating, sticky | rotating cambia de IP por petición; sticky mantiene la misma IP pública hasta que expire. |
| -country-<iso2> | us, de, gb, jp, br, etc. | Código de país ISO 3166-1 alpha-2 para geo-targeting estricto. |
| -city-<name> | newyork, berlin, tokyo... | Filtrado por ciudad específica en nodos disponibles. |
| -asn-<asn> | as7922, as24940, as15169... | Targeting a nivel de Sistema Autónomo (ASN). |
| -carrier-<carrier> | verizon, att, vodafone... | Operador de red celular móvil (solo aplicable con product-mobile). |
| -session-<id> | Cualquier texto alfanumérico | Identificador de sesión sticky para fijar la misma IP de salida. |
| -sesstime-<minutes> | 1 a 120 minutos | Duración de la sesión sticky antes de la rotación forzada. Por defecto: 10. |
3. Rotating vs Sticky: ¿Cuál elegir?
Cada petición HTTP saliente se despacha a través de una IP residencial o móvil distinta. Ideal para rastreo masivo (SERP, e-commerce, listados) donde cada página es independiente.
mode-rotatingMantiene la misma IP pública para todas las peticiones con el mismo identificador de sesión durante el tiempo configurado (1 a 120 minutos). Imprescindible para login, carritos y flujos multi-paso.
session-xyz-sesstime-30¿Necesitás crear credenciales por código?
Explorá la referencia interactiva de la Management API y probá endpoints en vivo con el Playground.