Documentação da API de proxies e métodos de conexão
Saiba como conectar o proxy residencial IPKite a códigos e ferramentas, e use a API de desenvolvedor para consultar saldo, histórico de compras e lista de proxies, com exemplos práticos.
Início rápido com proxy residencial
Ao comprar um proxy residencial, seu nome de usuário e senha do proxy serão exibidos na tela do membro. Há apenas um endereço de conexão, e você define o país, cidade e sessão adicionando valores ao nome de usuário. Você pode verificar a conexão imediatamente com o comando abaixo.
- Compra: Na tela do membro, escolha os GB desejados para comprar um proxy residencial.
- Confirmação: verifique o nome de usuário (USERNAME) e senha (PASSWORD) do proxy na tela do membro.
- Conexão: envie solicitações para o endereço gw.ipkite.com usando a porta HTTP 7000 ou SOCKS5 7100.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Formato das informações de conexão do proxy
Todas as conexões de proxies residenciais usam o mesmo endereço. HTTP/HTTPS usa porta 7000, SOCKS5 usa 7100. Adicione parâmetros com hífen após o username, usando apenas os necessários.
| Item | Valor | Descrição |
|---|---|---|
| Endereço | gw.ipkite.com | Endereço de conexão para todos os proxies residenciais |
| Portas HTTP/HTTPS | 7000 | Conectar a sites HTTP/HTTPS via proxy HTTP |
| Porta SOCKS5 | 7100 | Conexão em ferramentas e apps compatíveis com SOCKS5 |
| cc | Código de país de duas letras (minúsculas) | Exemplo: cc-us, cc-gb, cc-de |
| city | Nome da cidade (minúsculas, sem espaços) | Exemplo: city-newyork, city-london |
| sess | Nome de sessão em caracteres alfanuméricos | Manter o mesmo IP enquanto usar o mesmo valor |
| ttl | 1~1,440 (minutos) | Tempo para manter a sessão fixa |
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000Exemplos de proxy rotativo e sessão fixa
Sem sessão no nome de usuário, cada solicitação recebe um novo IP (rotativo). Com sess e ttl, a mesma IP é mantida por 1-1.440 minutos (sessão fixa). Mude o valor sess para novo 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/Exemplo de targeting por país e cidade
Use o parâmetro 'cc' para escolher entre 174 países/regiões, e 'city' para filtrar por cidades principais. O targeting por país/cidade funciona em sessões rotativas e fixas.
curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/Exemplo de proxy com Python requests
No Python requests, use o mesmo endereço para HTTP e HTTPS em 'proxies'. Para SOCKS5, instale requests[socks] e use o prefixo 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)Exemplo de proxy em Node.js
Em Node.js, use ProxyAgent do undici ou o pacote https-proxy-agent. Ambos métodos requerem apenas uma linha com o endereço do 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);Autenticação e endereço base da API para desenvolvedores
A API para desenvolvedores é REST e todas as respostas são em JSON. Ao gerar uma chave API na tela da conta, uma chave que começa com ipk_live_ será exibida apenas uma vez, então salve-a imediatamente em um local seguro. Inclua Bearer e a chave API no cabeçalho Authorization de todas as solicitações.
- Endereço base: https://ipkite.com/api/v1
- Cabeçalho de autenticação: Authorization: Bearer <API key>
- Limite de chamadas: 120 por minuto
- Formato da resposta: JSON, em caso de sucesso "ok": true
curl https://ipkite.com/api/v1/balance \
-H "Authorization: Bearer ipk_live_YOUR_API_KEY"Endpoint da API para desenvolvedores
| Método | Rota | Conteúdo | Principais valores de resposta |
|---|---|---|---|
| GET | /balance | Saldo atual | balance, currency |
| GET | /orders | Lista de histórico 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 fixo: ip, port, username, password, country, expires_at |
{"ok":true,"balance":"25.00","currency":"USD"}Respostas de erro e limites da API
Se a chave da API estiver ausente ou incorreta, você receberá uma resposta 401 HTTP. Verifique o nome do cabeçalho, o espaço após 'Bearer' e se a chave está completa. O limite é 120 chamadas por minuto. Para verificar saldo ou tráfego restante periodicamente, uma consulta por minuto é suficiente para ficar dentro do limite.
{"ok":false,"error":"unauthorized"}