프록시 가져오기

프록시 가져오기

대상에 최적화된 프록시 엔드포인트를 가져옵니다.

엔드포인트

GET /v1/proxy

파라미터

파라미터	타입	필수	설명
target	string	예	대상 도메인 (예: amazon.com)
session_lock	boolean	아니오	세션 동안 동일 IP 유지 (기본값: false)
country	string	아니오	ISO 3166-1 alpha-2 국가 코드
ip_type	string	아니오	residential, datacenter, dedicated 중 하나
session_ttl	integer	아니오	세션 타임아웃(초) (기본값: 1800)
auto_heal	boolean	아니오	자동 페일오버 활성화 (기본값: true)

요청

curl "https://api.hydraskill.ai/v1/proxy?target=amazon.com&session_lock=true&country=US" \
  -H "Authorization: Bearer sk-your-key"

응답

{
  "proxy_id": "px_abc123",
  "host": "us-res-42.proxy.hydraskill.ai",
  "port": 8080,
  "username": "session_abc123",
  "password": "px_token_xyz",
  "ip": "203.0.113.42",
  "country": "US",
  "type": "residential",
  "session_lock": true,
  "expires_at": "2026-05-30T16:30:00Z",
  "protocol": "http"
}

HTTP 클라이언트와 함께 사용하기

proxy = client.get_proxy(target="amazon.com", session_lock=True)

# requests에서 쓸 수 있는 dict로 변환
proxies = proxy.to_dict()
# {'http': 'http://user:pass@host:port', 'https': 'http://user:pass@host:port'}

response = requests.get(url, proxies=proxies)

오류 코드

코드	의미
400	필수 파라미터 target 누락
401	잘못된 API key
402	잔액 부족 / 플랜 한도 도달
429	rate limit 초과
503	요청 조건에 맞는 가용 프록시 없음