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

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token

Ejemplo:

curl "https://shifter.io/api/v1/backconnect/MEMBERSHIP_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.

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token
ips[]	body	yes	Array of IPv4 addresses to whitelist

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

curl -X POST "https://shifter.io/api/v1/backconnect/MEMBERSHIP_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

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token

Respuesta:

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

Actualizar la asignación de geolocalización

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

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token
geo[]	body	yes	Array of ISO-3166-1 alpha-2 country codes
advanced_geo[]	body	no	Array of advanced geo filters (city or ASN)

curl -X POST "https://shifter.io/api/v1/backconnect/MEMBERSHIP_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.

Parameter	In	Required	Description
membership	path	yes	The plan ID
api_token	query	yes	Your account API token

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