Referencia de la API REST
Esta sección cubre 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, ISP Proxies y planes heredados basados en puertos.
URLs base
Sección titulada «URLs base»| Producto | URL base |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| ISP Proxies | 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"ISP Proxies y planes heredados
Sección titulada «ISP Proxies y planes 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_MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"El parámetro de ruta {membership} en los endpoints de ISP y heredados es el ID de tu plan, que se muestra en el panel en la página del plan.
Errores
Sección titulada «Errores»Cada endpoint devuelve un estado HTTP estándar. Los cuerpos de respuesta para 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 mal formado o faltante) |
401 | Credenciales inválidas o faltantes |
403 | El plan no permite esta función o endpoint |
404 | Membresía o recurso no encontrado |
429 | Demasiadas solicitudes, reintenta con backoff |
500 | Error interno, reintenta con backoff |
Sobrescritura de métodos
Sección titulada «Sobrescritura de métodos»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 los métodos no estándar.