Referência da API

Documentação

Tudo que você precisa para integrar o ProxyHat em suas aplicações

Início Rápido

Configure e comece a usar em minutos

curl -x http://USERNAME:PASSWORD@proxy.proxyhat.com:8080 \
     https://api.example.com/data

Autenticação

Proteja suas requisições de API com suas credenciais

Autenticação por Chave de API

Todas as requisições requerem que sua chave de API seja passada na URL do proxy. Sua chave de API pode ser encontrada no seu painel após o cadastro.

http://USERNAME:PASSWORD@proxy.proxyhat.com:PORT

Endpoints de Proxy

Endpoints de gateway de proxy disponíveis

Residencial
HTTP/HTTPS
residential.proxyhat.com
Portas:8080, 8443

IPs residenciais premium com roteamento de qualidade filtrado por AI

Datacenter
HTTP/HTTPS
dc.proxyhat.com
Portas:8080, 8443

Proxies de datacenter de alta velocidade para operações em massa

Parâmetros de Requisição

Personalize suas requisições de proxy com estas opções

ParâmetroTipoDescriçãoExemplo
countrystringCódigo do país alvo (ISO 3166-1)country=US
citystringNome da cidade alvocity=NewYork
sessionstringIdentificador de sessão persistentesession=abc123
ttlnumberTempo de vida da sessão em segundosttl=600

Exemplos de Código

Exemplos de implementação em linguagens populares

Python
import requests

proxy = "http://user:pass@residential.proxyhat.com:8080"
response = requests.get(
    "https://httpbin.org/ip",
    proxies={"http": proxy, "https": proxy}
)
Node.js
const fetch = require('node-fetch');
const HttpsProxyAgent = require('https-proxy-agent');

const agent = new HttpsProxyAgent(
  'http://user:pass@residential.proxyhat.com:8080'
);
fetch('https://httpbin.org/ip', { agent });
Go
proxyURL, _ := url.Parse(
  "http://user:pass@residential.proxyhat.com:8080",
)
client := &http.Client{
  Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
}
resp, _ := client.Get("https://httpbin.org/ip")

Cabeçalhos de Resposta

Metadados retornados com cada requisição via proxy

X-ProxyHat-IP

O IP do proxy usado para esta requisição

Exemplo:203.0.113.45
X-ProxyHat-Country

País do IP do proxy

Exemplo:US
X-ProxyHat-Latency

Latência da requisição em milissegundos

Exemplo:48

Códigos de Erro

Erros comuns e como tratá-los

CódigoStatusDescriçãoResolução
407Autenticação NecessáriaCredenciais inválidas ou ausentesVerifique seu nome de usuário e senha
429Limite ExcedidoMuitas requisiçõesReduza a frequência de requisições ou faça upgrade do plano
503IndisponívelNenhum proxy disponível para os critériosTente um país diferente ou aguarde

Limites de Taxa

Limites de uso baseados no seu plano

Inicial
100
requisições/minuto
largura de banda de 10 GB
Pro
500
requisições/minuto
largura de banda de 100 GB
Empresarial
Ilimitado
requisições/minuto
largura de banda de Ilimitado

Precisa de limites maiores?

Entre em contato com nossa equipe para planos empresariais personalizados com requisições ilimitadas e infraestrutura dedicada.

Pronto para começar?

Crie sua conta e comece a usar nossa infraestrutura de proxy em minutos.