Documentación de la API de proxies y métodos de conexión
Hemos recopilado métodos para conectar IPKite proxy residencial a códigos y herramientas, junto con la API de desarrollador para consultar saldo, historial de compras y lista de proxies, con ejemplos incluidos.
Inicio rápido de proxy residencial
Al comprar un proxy residencial, en la pantalla del miembro se mostrarán el nombre de usuario y la contraseña del proxy. Hay una dirección de conexión, y puedes especificar el país, la ciudad y la sesión añadiendo valores al nombre de usuario. Puedes verificar la conexión inmediatamente con una sola línea de comando.
- Compra: En tu panel, selecciona los GB que necesites para proxies residenciales.
- Verificación: en la pantalla del miembro, revisa el nombre de usuario (USERNAME) y la contraseña (PASSWORD) del proxy.
- Conexión: envía solicitudes a gw.ipkite.com en puerto HTTP 7000 o SOCKS5 7100.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Formato de información de conexión de proxies
Todas las conexiones de proxies residenciales usan la misma dirección. Las solicitudes HTTP y HTTPS se envían al puerto 7000, y las conexiones SOCKS5 al puerto 7100. Añade parámetros al nombre de usuario con un guion (-), y usa solo los parámetros que necesites.
| Ítem | Valor | Descripción |
|---|---|---|
| Dirección | gw.ipkite.com | Dirección de conexión para todas las conexiones de proxies residenciales |
| Puertos HTTP/HTTPS | 7000 | Conectar a sitios HTTP/HTTPS mediante proxy HTTP |
| Puerto SOCKS5 | 7100 | Conéctate en herramientas y aplicaciones que soporten SOCKS5 |
| cc | Código de país de dos letras (minúsculas) | Ej: cc-us, cc-gb, cc-de |
| city | Nombre de ciudad (minúsculas, sin espacios) | Ej: city-newyork, city-london |
| sess | Nombre de sesión alfanumérico | Mantener la misma IP mientras se usa el mismo valor |
| ttl | 1-1,440 (minutos) | Duración de la sesión fija |
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000Ejemplos de proxy rotativo y sesión fija
Si no agregas un valor sess al nombre de usuario, funcionará como un proxy rotativo que asigna una nueva IP por solicitud. Si agregas sess y ttl, se convierte en una sesión fija que mantiene la misma IP durante el tiempo especificado en ttl (1-1,440 minutos). Cambia el valor de sess cuando necesites una nueva IP.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Ejemplo de targeting por país/ciudad
Usa el parámetro cc para elegir entre 174 países/regiones, y el parámetro city para especificar ciudades principales. El targeting por país/ciudad se puede usar tanto en sesiones rotativas como fijas.
curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/Ejemplo de proxy en Python requests
En Python requests, usa la misma dirección de proxy para HTTP y HTTPS en el valor de proxies. Para conectarte con SOCKS5, instala requests[socks] y cambia la dirección a socks5h://.
import requests
proxy = "http://USERNAME-cc-us-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000"
proxies = {"http": proxy, "https": proxy}
r = requests.get("https://example.com/", proxies=proxies, timeout=30)
print(r.status_code)Ejemplo de proxy en Node.js
En Node.js, puedes conectarte usando ProxyAgent de undici o el paquete https-proxy-agent. Ambos métodos solo requieren una línea de dirección de proxy.
import { ProxyAgent, fetch } from "undici";
const agent = new ProxyAgent("http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000");
const res = await fetch("https://example.com/", { dispatcher: agent });
console.log(res.status);Autenticación y dirección base de la API para desarrolladores
La API para desarrolladores es REST y todas las respuestas son JSON. Genera una clave API en la pantalla de la cuenta; la clave que comienza con ipk_live_ se muestra solo una vez, así que guárdala en un lugar seguro inmediatamente. Incluye Bearer y la clave API en el encabezado Authorization de todas las solicitudes.
- URL base: https://ipkite.com/api/v1
- Encabezado de autenticación: Authorization: Bearer <API Key>
- Límite de llamadas: 120 por minuto
- Formato de respuesta: JSON, éxito si "ok": true
curl https://ipkite.com/api/v1/balance \
-H "Authorization: Bearer ipk_live_YOUR_API_KEY"Endpoint de la API para desarrolladores
| Método | Ruta | Contenido | Valores de respuesta principales |
|---|---|---|---|
| GET | /balance | Saldo actual | balance, currency |
| GET | /orders | Lista de compras | code, product, summary, amount, status, created_at |
| GET | /proxies | Lista de proxies comprados | Residencial: username, password, host, http_port, socks_port, traffic_gb_left / IP fija: ip, port, username, password, country, expires_at |
{"ok":true,"balance":"25.00","currency":"USD"}Respuestas de error y límites de la API
Si falta la clave API o es incorrecta, recibirás una respuesta HTTP 401. Verifica el nombre del encabezado, el espacio después de 'Bearer' y que la clave esté completa. El límite es 120 llamadas por minuto. Para consultas periódicas de saldo o tráfico, una vez por minuto es suficiente.
{"ok":false,"error":"unauthorized"}