API de proxies ISP
Utilice esta API para enumerar el pool de IP de proxies ISP y gestionar la lista blanca de IP de origen. Para el uso del proxy a nivel de protocolo (host:port, credenciales), consulte Productos → Proxies ISP.
Autenticación
Sección titulada «Autenticación»Todos los endpoints se autentican con un parámetro de consulta api_token. Genere un token en el panel en Account → API Tokens.
?api_token=YOUR_API_TOKENEl parámetro de ruta {membership} acepta ambas formas: el ID numérico del plan (el número que aparece en la página del plan en el panel) o su ID de API (el código corto al final de la URL del plan en el panel, por ejemplo https://shifter.io/panel/membership/DeeJ). Ambos identifican el mismo plan.
Listar proxies
Sección titulada «Listar proxies»Devuelve cada IP fija de su plan con el puerto y las credenciales compartidas. El mismo puerto (1337) y el mismo usuario/contraseña se aplican en todo el pool, solo cambia la IP.
| Parameter | In | Required | Description |
|---|---|---|---|
membership | path | yes | El ID del plan (numérico o ID de API) |
api_token | query | yes | Your account API token |
Ejemplo:
curl "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/proxies?api_token=YOUR_API_TOKEN"Respuesta:
{ "error": null, "code": 200, "data": [ "185.199.108.153:1337", "185.199.108.154:1337", "185.199.108.155:1337" ]}Cada entrada tiene el formato ip:port. El puerto (1337) y el usuario/contraseña son los mismos para todas las IP del grupo: solo cambia la IP; las credenciales están en el panel, en My Plans → ISP Proxies. Los proxies ISP están disponibles en EE. UU., Canadá, Reino Unido, Francia, Alemania, España e Italia. Los países de sus IP se eligen una vez en la compra y quedan fijos, consulte Configuración de país.
IP de origen autorizadas
Sección titulada «IP de origen autorizadas»Añada a la lista blanca las IP de origen para que sus scrapers puedan omitir la autenticación HTTP Basic en cada solicitud. La lista blanca es a nivel de cuenta: cualquier origen en la lista blanca puede usar cualquier IP fija del pool.
Listar IP autorizadas
Sección titulada «Listar IP autorizadas»| Parameter | In | Required | Description |
|---|---|---|---|
membership | path | yes | The plan ID |
api_token | query | yes | Your account API token |
Respuesta:
{ "error": null, "code": 200, "data": [ "198.51.100.10", "203.0.113.42" ]}Actualizar IP autorizadas
Sección titulada «Actualizar IP autorizadas»Reemplaza la lista de IP autorizadas con 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/static-residential/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"