Referencia de la API REST
Esta sección abarca las APIs de gestión de proxies: control programático sobre búsquedas de geolocalización, IPs de origen autorizadas, valores predeterminados de geolocalización y la lista de proxies para Residential Proxies, los planes ISP heredados con IP fija (pinned-IP) y los planes heredados basados en puertos. Los planes actuales de ISP Proxies no tienen API de gestión; sus líneas de proxy se encuentran en la página del plan dentro del panel, consulta ISP Proxies.
URLs base
Sección titulada «URLs base»| Producto | URL base |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| Planes ISP heredados (IPs fijas) | https://shifter.io/api/v1/static-residential |
| Planes heredados | https://shifter.io/api/v1/backconnect |
Autenticación
Sección titulada «Autenticación»Residential Proxies
Sección titulada «Residential Proxies»Pasa tu api_key como parámetro de consulta. Crea claves en el panel en Account → API Keys.
curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"Planes ISP heredados y planes de puertos heredados
Sección titulada «Planes ISP heredados y planes de puertos heredados»Utiliza el token de API de tu cuenta como parámetro de consulta api_token. Genéralo en el panel en Account → API Tokens.
curl "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/proxies?api_token=YOUR_API_TOKEN"El parámetro de ruta {membership} acepta el Membership ID que se muestra en la página del plan en el panel (por ejemplo 68057) o el código corto de la URL del plan (por ejemplo Rxqk).
Errores
Sección titulada «Errores»Cada endpoint devuelve un estado HTTP estándar. Los cuerpos de respuesta de los fallos incluyen un objeto JSON con error y message.
{ "error": "invalid_api_key", "message": "The provided api_key is missing or invalid"}| Estado | Significado |
|---|---|
200 | Éxito |
400 | Solicitud incorrecta (parámetro requerido malformado o ausente) |
401 | Credenciales inválidas o ausentes |
403 | El plan no permite esta función o endpoint |
404 | Membership o recurso no encontrado |
429 | Demasiadas solicitudes, reintenta con backoff |
500 | Error interno, reintenta con backoff |
Anulaciones de método
Sección titulada «Anulaciones de método»Algunos endpoints de gestión heredados aceptan POST con un campo de formulario _method=PUT como equivalente a PUT, útil cuando tu cliente HTTP elimina métodos no estándar.