Dokumentacja API

Dokumentacja

Wszystko, czego potrzebuje Pan/Pani do integracji ProxyHat z aplikacjami

Szybki start

Uruchom w kilka minut

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

Uwierzytelnianie

Zabezpiecz żądania API swoimi poświadczeniami

Uwierzytelnianie kluczem API

Wszystkie żądania wymagają przekazania klucza API w adresie URL proxy. Klucz API można znaleźć w panelu po zarejestrowaniu się.

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

Punkty końcowe Proxy

Dostępne punkty końcowe bramki proxy

Rezydencjalne
HTTP/HTTPS
residential.proxyhat.com
Porty:8080, 8443

Premium rezydencjalne IP z routingiem jakości filtrowanym przez AI

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

Szybkie proxy datacenter do operacji zbiorczych

Parametry żądania

Dostosuj żądania proxy za pomocą tych opcji

ParametrTypOpisPrzykład
countrystringKod kraju docelowego (ISO 3166-1)country=US
citystringNazwa miasta docelowegocity=NewYork
sessionstringIdentyfikator sesji trwałejsession=abc123
ttlnumberCzas życia sesji w sekundachttl=600

Przykłady kodu

Przykłady implementacji w popularnych językach

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")

Nagłówki odpowiedzi

Metadane zwracane z każdym żądaniem proxy

X-ProxyHat-IP

Adres IP proxy użyty dla tego żądania

Przykład:203.0.113.45
X-ProxyHat-Country

Kraj adresu IP proxy

Przykład:US
X-ProxyHat-Latency

Opóźnienie żądania w milisekundach

Przykład:48

Kody błędów

Częste błędy i sposoby ich obsługi

KodStatusOpisRozwiązanie
407Wymagane uwierzytelnienieNieprawidłowe lub brakujące poświadczeniaSprawdź nazwę użytkownika i hasło
429Limit przekroczonyZbyt wiele żądańZmniejsz częstotliwość żądań lub ulepsz plan
503NiedostępneBrak dostępnych proxy dla kryteriówSpróbuj innego kraju lub poczekaj

Limity zapytań

Limity użytkowania oparte na Pana/Pani planie

Starter
100
żądań/minutę
przepustowość 10 GB
Pro
500
żądań/minutę
przepustowość 100 GB
Enterprise
Nieograniczone
żądań/minutę
przepustowość Nieograniczone

Potrzebuje Pan/Pani wyższych limitów?

Skontaktuj się z naszym zespołem w sprawie niestandardowych planów Enterprise z nieograniczonymi żądaniami i dedykowaną infrastrukturą.

Gotowy, aby rozpocząć?

Utwórz konto i zacznij korzystać z naszej infrastruktury proxy w kilka minut.