API 레퍼런스

문서

ProxyHat을 애플리케이션에 통합하는 데 필요한 모든 정보

빠른 시작

몇 분 만에 설정하고 시작하세요

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

인증

자격 증명으로 API 요청을 보호하세요

API 키 인증

모든 요청에는 프록시 URL에 API 키를 전달해야 합니다. API 키는 가입 후 대시보드에서 확인하실 수 있습니다.

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

프록시 엔드포인트

사용 가능한 프록시 게이트웨이 엔드포인트

주거용

HTTP/HTTPS

residential.proxyhat.com

포트:8080, 8443

AI 필터링 품질 라우팅이 적용된 프리미엄 주거용 IP

데이터센터

HTTP/HTTPS

dc.proxyhat.com

포트:8080, 8443

대량 작업을 위한 고속 데이터센터 프록시

요청 매개변수

이 옵션으로 프록시 요청을 맞춤 설정하세요

매개변수	유형	설명	예시
`country`	string	대상 국가 코드 (ISO 3166-1)	`country=US`
`city`	string	대상 도시 이름	`city=NewYork`
`session`	string	고정 세션 식별자	`session=abc123`
`ttl`	number	세션 수명(초)	`ttl=600`

코드 예제

주요 언어로 작성된 구현 예제

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 });

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

응답 헤더

각 프록시 요청과 함께 반환되는 메타데이터

X-ProxyHat-IP

이 요청에 사용된 프록시 IP

예시:203.0.113.45

X-ProxyHat-Country

프록시 IP의 국가

예시:US

X-ProxyHat-Latency

요청 지연 시간(밀리초)

예시:48

오류 코드

일반적인 오류 및 처리 방법

코드	상태	설명	해결 방법
`407`	인증 필요	잘못되었거나 누락된 자격 증명	사용자 이름과 비밀번호를 확인하세요
`429`	요청 제한 초과	너무 많은 요청	요청 빈도를 줄이거나 플랜을 업그레이드하세요
`503`	사용 불가	기준에 맞는 사용 가능한 프록시 없음	다른 국가를 시도하거나 기다리세요

요청 제한

플랜별 사용 한도

스타터

100

요청/분

10 GB 대역폭

프로

500

요청/분

100 GB 대역폭

엔터프라이즈

무제한

요청/분

무제한 대역폭

더 높은 한도가 필요하신가요?

무제한 요청과 전용 인프라가 제공되는 맞춤형 엔터프라이즈 플랜에 대해 저희 팀에 문의하세요.

시작할 준비가 되셨나요?

계정을 생성하고 몇 분 만에 저희 프록시 인프라를 사용하세요.

시작하기 요금제 보기