Documentação
Documentação da API de proxy e integração
Conecte qualquer cliente HTTP ou SOCKS5 com um host e um login por rede, escolha localizações e sessões com chaves no nome de usuário e gerencie planos com a API REST.
Hosts e portas
Cada rede tem um host. HTTP e HTTPS compartilham a primeira porta, SOCKS5 usa a segunda. O nome de usuário e senha vêm do plano no seu painel e são os mesmos para ambos os protocolos.
| Rede | Host | HTTP(S) | SOCKS5 |
|---|---|---|---|
| Proxies residenciais | res.proxyhive.cc | 7000 | 7001 |
| Proxies móveis | mob.proxyhive.cc | 7100 | 7101 |
| Proxies ISP estáticos | isp.proxyhive.cc | 8000 | 8001 |
| Proxies de datacenter | dc.proxyhive.cc | 7200 | 7201 |
Planos de ISP estático listam cada endereço com sua própria porta em vez de um host compartilhado: conecte-se a ip:porta com o nome de usuário e senha do plano.
Chaves do nome de usuário
As chaves são anexadas ao seu nome de usuário com hífens e podem ser combinadas em qualquer ordem. Sem chaves, um plano rotativo retorna um endereço aleatório em qualquer país.
| Chave | O que faz | Redes |
|---|---|---|
| country-us | Código de país ISO de duas letras. | Residencial, móvel, datacenter |
| state-texas | Um estado dos EUA ou região de primeiro nível. | Residencial |
| city-new_york | Uma cidade, em minúsculas, espaços como sublinhados. | Residencial, móvel |
| carrier-tmobile | Uma operadora móvel em letras minúsculas, sem espaços. | Móvel |
| session-a1b2c3 | Mantém um IP para a sessão, de 6 a 10 letras ou dígitos. | Residencial, móvel, datacenter |
| ttl-30 | Minutos que uma sessão mantém seu IP, de 1 a 1.440. Padrão 10. | Residencial, móvel, datacenter |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
Exemplos de código
Substitua USER e PASS pelo login do seu plano. As amostras enviam uma solicitação através do gateway e imprimem a resposta.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
API REST
Endereço base https://proxyhive.cc/api/v1. As respostas são JSON e sempre trazem ok. Endpoints públicos não precisam de chave; endpoints de conta precisam do cabeçalho Authorization: Bearer com a chave de API da sua página de conta.
| Método | Caminho | O que faz | Chave |
|---|---|---|---|
| GET | /plans | Todos os planos com id, produto, tamanho, taxa e preço. | Não |
| GET | /locations | Países com tamanhos de pool, cidades e operadoras. | Não |
| GET | /balance | Seu saldo em USD. | Sim |
| POST | /orders | Compre um plano: id do plano e país (ou qualquer). | Sim |
| GET | /orders | Seus planos com logins, tráfego restante e expiração. | Sim |
| GET | /orders/{id} | Um plano pelo seu código. | Sim |
curl -X POST https://proxyhive.cc/api/v1/orders \
-H "Authorization: Bearer phk_..." \
-H "Content-Type: application/json" \
-d '{"plan": "res-100", "country": "any"}'{
"ok": true,
"order": {
"id": "HO-7K2M9QXR4T",
"product": "resi",
"plan": "res-100",
"quantity": 100,
"unit": "GB",
"status": "active",
"gateway": { "host": "res.proxyhive.cc", "http_port": 7000, "socks5_port": 7001, "username": "...", "password": "..." }
}
}Erros e limites
Chamadas com falha respondem ok: false com um código de erro e uma mensagem: unauthorized (401), bad_plan ou bad_country (400), funds (402, com o valor ainda necessário), network (503, nada foi cobrado) e rate_limited (429). Cada chave de API pode enviar 300 solicitações por minuto.
Comece com o ProxyHive
Crie uma conta em segundos, adicione saldo com criptomoedas e copie seu primeiro login de proxy. Todo plano começa em $30.