API de Gestión de Planes Heredados

Esta página cubre la API de gestión para planes antiguos basados en puertos (clientes heredados con un rango fijo de puertos en lugar de la puerta de enlace basada en tráfico). Utiliza estos endpoints para incluir en la lista blanca las IPs de origen, establecer los valores predeterminados de geolocalización por puerto y obtener la lista de puertos asignados.

Nota

Si tu plan está en el nuevo modelo basado en tráfico de Residential Proxies (puerta de enlace única p.shifter.io:443), utiliza en su lugar la API de Residential Proxies: la segmentación en el nuevo modelo se codifica en el nombre de usuario en cada solicitud, no se almacena como valor predeterminado del plan.

Autenticación

Todos los endpoints se autentican con un parámetro de consulta api_token. Genera un token en el panel en Account → API Tokens.

?api_token=YOUR_API_TOKEN

El parámetro de ruta {membership} es el ID de tu plan, mostrado en el panel en la página del plan.

IPs autorizadas

Los planes antiguos se autentican únicamente por IP de origen: incluye en la lista blanca las IPs desde las que se conectan tus scrapers.

Listar IPs autorizadas

GET https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

Parámetro	Ubicación	Obligatorio	Descripción
membership	path	sí	El ID del plan
api_token	query	sí	Tu token API de cuenta

Ejemplo:

curl "https://shifter.io/api/v1/backconnect/YOUR_PLAN_ID/authorized-ips?api_token=YOUR_API_TOKEN"

Respuesta:

{
  "ips": ["198.51.100.10", "203.0.113.42"]
}

Actualizar IPs autorizadas

PUT https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

Sustituye la lista de IPs autorizadas por los valores proporcionados.

Parámetro	Ubicación	Obligatorio	Descripción
membership	path	sí	El ID del plan
api_token	query	sí	Tu token API de cuenta
ips[]	body	sí	Array de direcciones IPv4 para incluir en la lista blanca

Ejemplo (codificado como formulario, con anulación de método):

curl -X POST "https://shifter.io/api/v1/backconnect/YOUR_PLAN_ID/authorized-ips?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&ips[]=198.51.100.10&ips[]=203.0.113.42"

Valores predeterminados de geolocalización

Los puertos antiguos tienen una asignación de geolocalización por plan. Configúrala una vez y cada puerto del plan enrutará a través de IPs en los países configurados (o filtros avanzados).

Obtener la asignación de geolocalización actual

GET https://shifter.io/api/v1/backconnect/{membership}/geo

Parámetro	Ubicación	Obligatorio	Descripción
membership	path	sí	El ID del plan
api_token	query	sí	Tu token API de cuenta

Respuesta:

{
  "geo": ["us", "gb"],
  "advanced_geo": []
}

Actualizar la asignación de geolocalización

PUT https://shifter.io/api/v1/backconnect/{membership}/geo

Parámetro	Ubicación	Obligatorio	Descripción
membership	path	sí	El ID del plan
api_token	query	sí	Tu token API de cuenta
geo[]	body	sí	Array de códigos de país ISO-3166-1 alpha-2
advanced_geo[]	body	no	Array de filtros geo avanzados (ciudad o ASN)

curl -X POST "https://shifter.io/api/v1/backconnect/YOUR_PLAN_ID/geo?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&geo[]=us&geo[]=uk&geo[]=ca"

Listar proxies

GET https://shifter.io/api/v1/backconnect/{membership}/proxies

Devuelve la lista de entradas host:port para cada puerto de tu plan antiguo.

Parámetro	Ubicación	Obligatorio	Descripción
membership	path	sí	El ID del plan
api_token	query	sí	Tu token API de cuenta

Respuesta:

{
  "proxies": [
    { "host": "apollo.p.shifter.io", "port": 10001 },
    { "host": "zeus.p.shifter.io", "port": 10002 },
    { "host": "cronos.p.shifter.io", "port": 10003 }
  ]
}

Anulaciones de método

Muchos clientes HTTP compatibles con proxies eliminan los métodos no estándar. La API de gestión acepta POST con un campo de formulario _method=PUT como equivalente a PUT.

Ver también

• Modelo de puertos antiguo
• Autenticación: en qué se diferencia la autenticación antigua de Residential Proxies e ISP Proxies